Genesis API 文档

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

文档订单簿 Δ

订单簿 Δ

TrialStartProMax

所选套利数据集中某个币种每一行的「订单簿 Δ」——公式与站点该列相同。CEX 配对:通过第一家交易所的卖单买入,卖入第二家交易所的买单,上限为该行的价差。DEX 行:由价差符号决定方向(≥ 0——卖入 CEX 买单,< 0——从卖单买入),符号反转则得 0。volume = 0——按订单簿最优价格。

GEThttps://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
coinstring币种代码(必填)
volumenumber0(默认)——订单簿最优价格,或 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.volumenumber计算数量,USD(0——最优价格)
order_delta.buy_price / sell_pricenumber | nullCEX 配对:该数量的买入和卖出价格
order_delta.side / cex_pricestring / number | nullDEX 行:CEX 一侧(sell 或 buy)和成交价格
order_delta.spread_pctnumber | null按订单簿逐档成交后的价差,%
order_delta.statusstringok;no_book——没有订单簿;exhausted——订单簿未能成交