Genesis API 文档

接入所需的一切:认证、限额、接口和响应结构。

文档币种订单簿

币种订单簿

TrialStartProMax

一个币种在所有交易所和市场上的订单簿——字段与 /orderbooks/book 相同。

GEThttps://api.genesisarbitrage.com/v1/orderbooks/coin/{coin}
在线试用
GET/v1/orderbooks/coin/BTC

密钥仅保存在你的浏览器中,除 API 外不会发送到任何地方。

粘贴你的密钥并发送请求——我们会显示截断后的响应。

查询参数

参数类型说明
{coin}string币种代码(必填)

请求示例

bash
curl "https://api.genesisarbitrage.com/v1/orderbooks/coin/BTC" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

响应示例

响应示例——一条数据,较长的值已缩短:

json
{
  "exchange": "Binance",
  "market": "spot",
  "coin": "BTC",
  "book_ts": 1794675858,
  "age_sec": 6,
  "stale": false,
  "source": "ws",
  "depth_limited": false,
  "levels_bid": 500,
  "levels_ask": 500,
  "best_bid": 96015.9,
  "best_ask": 96016,
  "bids": [[96015.9, 412300.5], [96015.8, 51020.3], …],
  "asks": [[96016, 388120.2], [96016.1, 20410.7], …],
  "walls_bid": [[95900, 2410000]],
  "walls_ask": [[96500, 1980000]],
  "depth_bid_usd": 61234567,
  "depth_ask_usd": 58765432
}

响应字段

字段类型说明
exchange / market / coinstring交易所、市场和币种
book_ts / age_sec / staleint / int / boolean订单簿时间、其时效(秒)以及过期标志(超过 30 秒)
source / depth_limitedstring / boolean订单簿来源——ws 或 rest;depth_limited——深度有限
levels_bid / levels_askint每侧订单簿的档数
best_bid / best_asknumber最优买价和卖价
bids / asks[number, number][]前 10 档:[价格, USD 金额]
walls_bid / walls_ask[number, number][]最大挂单墙:[价格, USD 金额]
depth_bid_usd / depth_ask_usdnumber最优价格 ±50% 范围内一侧的总深度,USD