获取成交记录

某个 DEX 市场的最新成交,最新的在前。无需密钥。

GET

某个市场的最新成交,最新的在前。成交的支付在 BNB Chain 上最终确认后,settled 就会变成 true,通常在几秒内。支付失败的成交会被撤销,并从列表中消失。

taker 是吃单方的方向:吃单方的订单与订单簿中等待的订单成交。钱包和账户永远不会出现。

返回会缓存 1 秒。这个接口计 1 权重。

无需密钥,任何人都可以读取。

路径参数

  • idstring必填

    市场 ID,比如 binference-2026-10-24:在这一天 UTC 00:00 到期的 bInference 额度。开放中的市场见 GET /dex/markets。

查询参数

  • limitinteger

    返回多少笔成交,1 到 500。不填时为 50。

返回

  • marketstring

    市场 ID。

  • tradesobject[]

    成交记录,最新的在前。

    • idstring

      成交 ID,在所属市场中唯一。

    • pricestring

      每 $1 额度的 USDT 价格。

    • sizestring

      成交的额度,以美元计。

    • taker"buy" | "sell"

      吃单方的方向:买单吃掉等待中的卖单时为 buy,反过来为 sell。

    • freshboolean

      购买 bInference 全新额度的成交为 true。

    • settledboolean

      支付在 BNB Chain 上最终确认后为 true。如果支付失败,这笔成交会被撤销,并从列表中消失。

    • timeinteger

      撮合的时间,以毫秒计。

错误

每个错误都以 JSON 返回:{ "error": { "code", "message" } },其中 code 是稳定的错误码,可以据此判断。

  • invalid_limit400

    limit 不是允许范围内的整数。

  • unknown_parameter400

    这个端点不接受的查询参数,或者同一个参数发送了两次。只发送这里列出的参数,每个一次,并按所示写法书写:其他请求在计入权重之前就会被拒绝。

  • not_found404

    DEX 尚未开放。

  • unknown_market404

    没有这个 ID 的开放中市场。已收盘的市场也会返回这个错误。市场 ID 请从 GET /dex/markets 获取。

  • rate_limited429

    这个 IP 地址一分钟内用掉了超过 1,200 权重。等待 Retry-After 中的秒数后再请求。

请求
curl "https://binference.io/api/v1/dex/markets/binference-2026-10-24/trades?limit=2"
返回
{  "market": "binference-2026-10-24",  "trades": [    {      "id": "4182.1",      "price": "0.960",      "size": "25.00",      "taker": "buy",      "fresh": false,      "settled": true,      "time": 1792173581000    },    {      "id": "4179.1",      "price": "1.000",      "size": "40.00",      "taker": "buy",      "fresh": true,      "settled": true,      "time": 1792173482000    }  ]}