获取订单簿 · bInference 文档

GET

某个市场中等待成交的订单，按价格汇总。买单按最优（最高）价在前，卖单按最优（最低）价在前，数量都以额度美元计。

bInference 的全新额度报价不在卖单里。在最新的市场中，它以 freshPrice 单独给出：任何数量都是 1.000，所以在那里买入的最优价不会高于 1.000。

返回会缓存 1 秒。depth 不超过 20 时计 1 权重，超过 20 时计 5 权重。

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

路径参数

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

查询参数

depthinteger
每一边返回多少个价格，1 到 100。不填时为 20。

marketstring
市场 ID。
seqinteger
市场的变更序号。市场每有一次变化，序号就会增加，所以序号越大，订单簿越新。
timeinteger
读取订单簿的时间，以毫秒计。
bidsobject[]
按价格排列的买单，最优（最高）价在前。
- pricestring
  每 $1 额度的 USDT 价格。
- sizestring
  这个价格上所有订单的额度合计，以美元计。
- ordersinteger
  在这个价格上等待的订单数。
asksobject[]
按价格排列的卖单，最优（最低）价在前。bInference 的全新额度报价不在其中：见 freshPrice。
- pricestring
  每 $1 额度的 USDT 价格。
- sizestring
  这个价格上所有订单的额度合计，以美元计。
- ordersinteger
  在这个价格上等待的订单数。
freshPricestring | null
bInference 全新额度的价格 "1.000"，只在最新的市场出现，任何数量都按这个价格。其他市场为 null。

错误

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

invalid_depth400
depth 不是 1 到 100 之间的整数。
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/book?depth=5"

{  "market": "binference-2026-10-24",  "seq": 4182,  "time": 1792173600000,  "bids": [    {      "price": "0.950",      "size": "120.00",      "orders": 3    },    {      "price": "0.948",      "size": "64.50",      "orders": 2    },    {      "price": "0.940",      "size": "210.00",      "orders": 4    }  ],  "asks": [    {      "price": "0.990",      "size": "50.00",      "orders": 1    },    {      "price": "0.995",      "size": "35.20",      "orders": 2    }  ],  "freshPrice": "1.000"}