Genesis API 文档
接入所需的一切:认证、限额、接口和响应结构。
文档订单簿 Δ
订单簿 Δ
TrialStartProMax
所选套利数据集中某个币种每一行的「订单簿 Δ」——公式与站点该列相同。CEX 配对:通过第一家交易所的卖单买入,卖入第二家交易所的买单,上限为该行的价差。DEX 行:由价差符号决定方向(≥ 0——卖入 CEX 买单,< 0——从卖单买入),符号反转则得 0。volume = 0——按订单簿最优价格。
GET
https://api.genesisarbitrage.com/v1/orderbooks/spreads/{dataset}?coin={coin}&volume=5000在线试用
GET
/v1/orderbooks/spreads/spot-futures?coin=BTC&volume=5000密钥仅保存在你的浏览器中,除 API 外不会发送到任何地方。
粘贴你的密钥并发送请求——我们会显示截断后的响应。
查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
{dataset} | string | 路径中的数据集:spot-spot、spot-futures、futures-futures、dex-spot 或 dex-futures |
coin | string | 币种代码(必填) |
volume | number | 0(默认)——订单簿最优价格,或 500、1000、2500、5000、10000 |
请求示例
bash
curl "https://api.genesisarbitrage.com/v1/orderbooks/spreads/spot-futures?coin=BTC&volume=5000" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
响应示例
响应示例——一条数据,较长的值已缩短:
json
{
"coin": "BTC",
"exchange_buy": "Binance",
"exchange_sell": "ByBit",
"market_buy": "spot",
"market_sell": "futures",
"price_buy": 96016,
"price_sell": 96046,
"ask_buy": 96016,
"bid_sell": 96045.8,
"spread_pct": 0.031,
"order_delta": {
"volume": 5000,
"buy_price": 96019.8,
"sell_price": 96039.2,
"spread_pct": 0.0202,
"status": "ok"
}
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
… | 数据集该行的全部字段——与其接口一致 | |
order_delta.volume | number | 计算数量,USD(0——最优价格) |
order_delta.buy_price / sell_price | number | null | CEX 配对:该数量的买入和卖出价格 |
order_delta.side / cex_price | string / number | null | DEX 行:CEX 一侧(sell 或 buy)和成交价格 |
order_delta.spread_pct | number | null | 按订单簿逐档成交后的价差,% |
order_delta.status | string | ok;no_book——没有订单簿;exhausted——订单簿未能成交 |