Genesis API 文档
接入所需的一切:认证、限额、接口和响应结构。
文档市场订单簿
市场订单簿
TrialStartProMax
单个市场的订单簿,与站点的「订单簿」窗口一致:最优价格、每侧 10 档(以 $ 计)、最大挂单墙、±50% 范围内的深度以及订单簿的时效。depth_limited——交易所只公布有限的深度,因此大额数量可能无法成交。
GET
https://api.genesisarbitrage.com/v1/orderbooks/book?exchange=Binance&market=spot&coin={coin}在线试用
GET
/v1/orderbooks/book?exchange=Binance&market=spot&coin=BTC密钥仅保存在你的浏览器中,除 API 外不会发送到任何地方。
粘贴你的密钥并发送请求——我们会显示截断后的响应。
查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
exchange | string | 交易所(不区分大小写) |
market | string | spot 或 futures |
coin | string | 币种代码(必填) |
请求示例
bash
curl "https://api.genesisarbitrage.com/v1/orderbooks/book?exchange=Binance&market=spot&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 / coin | string | 交易所、市场和币种 |
book_ts / age_sec / stale | int / int / boolean | 订单簿时间、其时效(秒)以及过期标志(超过 30 秒) |
source / depth_limited | string / boolean | 订单簿来源——ws 或 rest;depth_limited——深度有限 |
levels_bid / levels_ask | int | 每侧订单簿的档数 |
best_bid / best_ask | number | 最优买价和卖价 |
bids / asks | [number, number][] | 前 10 档:[价格, USD 金额] |
walls_bid / walls_ask | [number, number][] | 最大挂单墙:[价格, USD 金额] |
depth_bid_usd / depth_ask_usd | number | 最优价格 ±50% 范围内一侧的总深度,USD |