Genesis Arbitrage

Genesis Arbitrage · · 阅读约 22 分钟

加密货币订单簿 API:跨交易所的深度、成交价与滑点

简而言之

  • 订单簿 API 返回买单和卖单的各档位(每档的价格和数量),形式为 REST 快照,或通过 WebSocket 推送的变动数据流。最优买价和卖价只反映一笔交易最初的几美元。
  • 深度决定大额订单的价格。在一个假设的例子中,$10,000 的买单吃掉五档,平均价格比订单簿中间价高 25 个基点,跨交易所价差从 1.20% 缩小到 0.70%。
  • 在 Pro 和 Max 套餐中,Genesis API 返回 $500–$10,000 的现成成交价、套利行的订单簿 Δ、订单簿的时效与深度、滑点历史以及 DEX 滑点阶梯。仅提供 REST;订单簿比交易所滞后 5–20 秒。

加密货币订单簿 API 返回某个交易对当前的买单和卖单,按价格档位分组:每一档包含价格和该价格上挂出的数量。据此可以算出指定数量订单的成交价、滑点和市场深度;再结合两家交易所的订单簿,就能算出实际成交后价差还剩多少。

交易所以 REST 快照或 WebSocket 数据流的形式提供自己的订单簿,而 Pro 和 Max 套餐中的 Genesis API 则一次性提供多家交易所的现成成交价、深度和订单簿 Δ。

订单簿 API 返回什么

订单簿是某个交易对上所有挂出的限价单列表。买单(bid)按价格从高到低排序,卖单(ask)按价格从低到高排序。一档就是一个价格及该价格上的总数量;最优卖价与最优买价之间的差距就是订单簿的价差。

REST 快照是对单次请求的响应:该时刻的各档位。Binance 的订单簿接口是公开的,不需要 API 密钥;下面是请求 BTC/USDT 前五档的例子及响应(数字为假设):

curl "https://api.binance.com/api/v3/depth?symbol=BTCUSDT&limit=5"
{
  "lastUpdateId": 81273645120,
  "bids": [["96015.90000000", "1.25000000"], …],
  "asks": [["96016.00000000", "0.84100000"], …]
}

每一档以 [价格, 数量] 的字符串对返回,数量以币计:最优买单价值 1.25 × 96,015.9 = $120,019.88。limit 参数默认值为 100,每侧最多 5,000 档(Binance 文档)。

WebSocket 数据流由交易所通过持久连接主动推送。Binance 有两类订单簿数据流:btcusdt@depth5、btcusdt@depth10 和 btcusdt@depth20 推送前 5、10 或 20 档,而 btcusdt@depth 只推送变动。两者都每 1000 毫秒更新一次,加上 @100ms 后缀则为每 100 毫秒一次(Binance WebSocket 数据流)。

完整的本地订单簿由快照加增量数据流构建,需要把快照的 lastUpdateId 与事件的更新 ID 对上;如果漏掉一个事件,就要从头重建订单簿。

方式得到什么适用场景
REST 快照请求时刻的档位,Binance 每侧最多 5,000 档一次性检查、低频轮询
WebSocket 数据流每 100–1000 毫秒推送前几档或变动内存中的本地订单簿、交易机器人
通过 REST 调用 Genesis API[价格, USD 金额] 形式的档位、成交价、深度和订单簿时效对比交易所、核查套利机会

为什么最优买卖价在大额下会误导

最优卖价只是第一档的价格。大于该档数量的市价买单会继续吃下后面更贵的档位,平均成交价随之上升——这就是滑点。

一个假设的例子:交易所 A 上的代币 ABC,最优买价 0.9996,最优卖价 1.0004,订单簿中间价 1.0000。$10,000 的市价买单吃掉五档卖单:

卖价订单簿中,$成交,$币数
1.00041,1001,1001,099.56
1.00101,4001,4001,398.60
1.00182,6002,6002,595.33
1.00303,0003,0002,991.03
1.00506,0001,9001,890.55

该订单共买入 9,975.07 个币。平均成交价就是 VWAP,即成交量加权平均价:10,000 / 9,975.07 ≈ 1.0025。

相对最优卖价的滑点:(1.0025 − 1.0004) / 1.0004 × 100 ≈ 0.21%。相对订单簿中间价:(1.0025 − 1.0000) / 1.0000 × 10,000 = 25 个基点。其中 4 个基点是订单簿价差的一半,每笔市价买单都要付;其余 21 个来自深度。

±X% 范围内的市场深度与大单墙

市场深度是距最优价一定范围内订单的总数量。在这个例子中,最优卖价 +0.2% 以内(到 1.0024)的卖单合计 1,100 + 1,400 + 2,600 = $5,100,+0.5% 以内(到 1.0054)合计 $14,100。

把深度当作容量来读:大于 +0.2% 内深度的订单,会在该边界之外的档位成交。在交易所 A 上,$5,000 的买单可以落在边界之内,$10,000 的买单则不行。

大单墙是单一档位上的大额挂单,明显大于相邻档位:例子中 1.0050 上的 $6,000。大单墙在时会撑住价格,但可能在你的订单到达前一秒被撤掉,买单就会在它后面的档位成交。

在 Genesis API 中,深度来自 /orderbooks/book(单个市场的订单簿)和 /orderbooks/coin/{coin}(某个币种在所有交易所和市场的订单簿)(市场订单簿,币种订单簿)。响应包含前 10 档 bids 和 asks([价格, USD 金额]),最大的大单墙在 walls_bid 和 walls_ask 中,一侧在最优价 ±50% 范围内的全部深度在 depth_bid_usd 和 depth_ask_usd 中。±50% 的范围很宽,所以针对具体金额,请看各档位或现成的成交价。

订单簿时效:过期订单簿与有限深度

每个订单簿快照都有时效。如果一家交易所的订单簿比另一家旧 15 秒,两者之间的部分价差可能只是时间差:较旧订单簿上的价格已经变动。

在 Genesis API 中,订单簿比交易所滞后 5–20 秒,且每个订单簿都带有自己的时效。文档中 /orderbooks/book 响应的开头:

{
  "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,
  …
}

book_ts 是订单簿的时间(Unix 秒),age_sec 是其时效(秒),stale: true 表示订单簿已超过 30 秒。source 表示订单簿从交易所获取的方式:通过 WebSocket(ws)或 REST 请求(rest)。

depth_limited: true 表示交易所只公布有限的深度:合计数量不完整,大额订单可能无法成交。订单耗尽时,/orderbooks/exec 返回 null 而不是价格,订单簿 Δ 返回 exhausted 状态。

跨交易所的可成交价差:订单簿 Δ

回到假设的例子。在交易所 B 上,最新成交价为 1.0120,最优买价 1.0116,卖价 1.0124。B 的买单为:1.0116 上 $1,100,1.0110 上 $1,300,1.0102 上 $2,800,1.0090 上 $2,900,1.0070 上 $5,000。

把 $10,000 卖进这些买单,用同样的公式得到 VWAP 为 1.0095。这比 B 订单簿中间价低 (1.0120 − 1.0095) / 1.0120 × 10,000 ≈ 24.7 个基点。

价差的计算方式在 A 买入 → 在 B 卖出价差
最新成交价,如表格行所示1.0000 → 1.01201.20%
订单簿最优价1.0004 → 1.01161.12%
成交 $10,000 之后1.0025 → 1.00950.70%

行价差:(1.0120 − 1.0000) / 1.0000 × 100 = 1.20%。成交之后:(1.0095 − 1.0025) / 1.0025 × 100 ≈ 0.70%。这一行对 $10,000 承诺 $120,经过订单簿之后只剩约 $70:10,000 × 0.006983 ≈ 69.83。

损失的 50 个基点中,8 个花在最新成交价与最优挂单之间的差距上,另外 42 个花在两个订单簿的深度上。

订单簿 Δ 是 Genesis Arbitrage 对“按指定金额通过订单簿重新计算的某一行价差”的称呼;在网站上,它是套利表格中的「订单簿 Δ」列,例如 Spot – Futures。在 API 中,它来自 /orderbooks/spreads/{dataset}:spot-spot、spot-futures、futures-futures、dex-spot 或 dex-futures 数据集中某个币种的每一行都带有一个 order_delta 对象(订单簿 Δ)。

order_delta 包含所选金额下的 buy_price 和 sell_price、成交后的 spread_pct 以及 status:ok、no_book(没有订单簿)或 exhausted(订单簿未能成交完)。volume 为 0(订单簿最优价)或 500、1000、2500、5000、10000,结果不会超过该行的价差。DEX 行不带价格对,而是带 side 和 cex_price:CEX 一侧及其成交价。

成交价本身(所有市场一次返回)来自 /orderbooks/exec:形如 Binance|spot|BTC 的键下是一个 [买入价, 卖出价] 对,订单簿太薄时为 null(成交价格)。

包含转币和网络检查的完整流程,见跨交易所加密货币套利。

Python 示例:行价差与成交后价差

脚本选取价差不低于 0.5% 的 Spot – Spot 机会,对价差最宽的十个币种以 $5,000 请求订单簿 Δ,并打印订单簿吃掉了多少个基点。密钥取自环境变量 GENESIS_API_KEY。遇到 429 和 503 时,脚本等待 Retry-After 秒;如果等待超过一分钟(说明月度额度已用完),脚本就停止。

import os
import time
import requests

BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
VOLUME = 5000      # dollars per leg
MIN_SPREAD = 0.5   # row spread, %


def get(path, params):
    for _ in range(3):
        r = requests.get(BASE + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):
            wait = int(r.headers.get("Retry-After", "5"))
            if wait > 60:  # the monthly quota is used up
                break
            time.sleep(wait)
            continue
        r.raise_for_status()
        return r.json()["data"]
    raise RuntimeError("API did not answer, try again later")


rows = get("/arbitrage/spot-spot", {"min_spread": MIN_SPREAD})
rows.sort(key=lambda x: x["spread_pct"], reverse=True)
coins = list(dict.fromkeys(x["coin"] for x in rows))[:10]

for coin in coins:
    data = get("/orderbooks/spreads/spot-spot",
               {"coin": coin, "volume": VOLUME})
    for row in data:
        od = row["order_delta"]
        if row["spread_pct"] < MIN_SPREAD or od["status"] != "ok":
            continue  # no_book or exhausted: the size will not fill
        lost = (row["spread_pct"] - od["spread_pct"]) * 100
        print(f'{coin} {row["exchange_buy"]}→{row["exchange_sell"]}'
              f' {row["spread_pct"]:.2f}% → {od["spread_pct"]:.2f}%,'
              f' the books ate {lost:.0f} bps')
    time.sleep(0.25)  # up to 4 requests per second: Pro allows 5

脚本最多发起 11 次调用,币种之间间隔 0.25 秒。循环运行的频率不要高于 meta.freshness_sec:Pro 为 10 秒,Max 为 5 秒(Genesis API 限额)。如需添加通知,请参阅 Python 加密货币套利机器人。

成交成本历史

单个快照无法告诉你当前的滑点对这个市场来说是否正常,或者订单簿是否比平时更薄。/orderbooks/exec-history 返回来自 Genesis Charts 的历史:成交 $500、$1,000、$2,500、$5,000 和 $10,000 相对订单簿中间价各花多少个基点,买入和卖出分开给出(成交历史)。

每个周期有 360 个点:1m 覆盖 6 小时,15m 覆盖 3.75 天,1h 覆盖 15 天,1d 约覆盖一年,数据自 2026 年 9 月 6 日起。一次请求最多可在 keys 参数中传入 8 个市场。买入值为正,卖出值为负;null 表示没有数据或订单簿未能成交完。Genesis API 不提供订单簿本身的历史快照。

import os
import statistics
import requests

KEY = "Binance|spot|BTC"
r = requests.get(
    "https://api.genesisarbitrage.com/v1/orderbooks/exec-history",
    headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
    params={"keys": KEY, "interval": "1h"},  # 360 hours, 15 days
    timeout=15,
)
r.raise_for_status()
data = r.json()["data"]
series = data["series"][KEY]
if series is None:
    raise SystemExit("market not found: " + KEY)
i = data["volumes_usd"].index(10000)  # the $10,000 buy series
buy = series["buy"][i]
known = [x for x in buy if x is not None]
if not known:
    raise SystemExit("no data for the period")
print("15-day median, bps:", statistics.median(known))
print("latest point, bps:", buy[-1])

假设 15 天中位数为 12 个基点,最新一点为 25,那么现在的成交成本是平时的两倍,此时可以考虑为这个币种提高价差阈值。

DEX:滑点阶梯、代币税与貔貅盘

DEX 资金池没有订单簿:兑换价格由资金池的公式决定,交易量相对流动性越大,价格偏移越多。因此 DEX 一侧用阶梯来评估——即一系列金额下的滑点。

/orderbooks/dex-slippage 按合约返回 $100、$500、$1,000、$2,500、$5,000、$10,000、$20,000、$50,000 和 $100,000 下的买入与卖出滑点、代币税以及貔貅盘(honeypot)标记,与网站上 DEX 表格的列一致(DEX 滑点)。在文档的示例响应中,买入滑点在 $10,000 时为 0.86%,在 $50,000 时为 3.12%,在 $100,000 时为 6.05%。

这决定了一个机会的上限:2% 的 DEX – CEX 价差在 $10,000 时能扛住资金池的滑点,在 $50,000 时则不行,这还没算手续费。阶梯中的 null 表示资金池没有足够流动性支撑该金额;响应中不含网络 gas,需要另行预算。

tax_buy_pct 和 tax_sell_pct 是代币的买入税和卖出税(%);null 表示没有来源,不能当作零来读。honeypot:no——没有迹象,suspect——各来源不一致,yes——可能无法卖出该代币。

手动检查代币,请参阅买入前如何检查代币;要查看 DEX 价格和流动性与 CEX 的对照,请参阅 DEX API。

Genesis API 中的订单簿:接口与套餐

任务接口
每个市场 $500–$10,000 的成交价/orderbooks/exec
某一行成交后的价差/orderbooks/spreads/{dataset}
10 档、大单墙、深度和订单簿时效/orderbooks/book
某个币种在所有交易所的订单簿/orderbooks/coin/{coin}
成交成本历史/orderbooks/exec-history
DEX 滑点、代币税和 honeypot 标记/orderbooks/dex-slippage

这六个接口都包含在 Pro 和 Max API 套餐中。Pro 每月 $100:500 万次调用,每秒 5 次请求,10 秒时效。Max 为 $200:1,000 万次调用,每秒 15 次请求,5 秒;在 Trial 和 Start 套餐上,订单簿接口返回 403 plan_restricted。

参数和响应示例见订单簿接口指南;API 数据概览请参阅加密货币 API 以及课程用于套利的 API 数据。

常见问题

为什么表格里的价差比我实际成交的大?

行价差来自最新成交价,而市价单是对着订单簿成交的,数量越大,平均价格偏离最优价越远。手续费和转移期间的价格变动还要另算。订单簿 Δ 显示在你的金额下价差还剩多少。

订单簿多久更新一次?

订单簿随每一笔新订单和撤单而变化;Binance 数据流每 100 或 1000 毫秒推送一次变动。在 Genesis API 中,订单簿比交易所滞后 5–20 秒(时效见 age_sec),响应在 Pro 上每 10 秒刷新一次,在 Max 上每 5 秒刷新一次。

Genesis API 有订单簿的 WebSocket 吗?

没有。Genesis API 仅提供 REST:HTTP GET 请求和 JSON 响应。实时订单簿数据流来自交易所自己的 WebSocket,通过交易所交易 API 下单的机器人需要的正是它。

有免费的订单簿 API 吗?

交易所有公开接口:/api/v3/depth 上的 Binance 订单簿无需密钥即可响应,但它只覆盖一家交易所,成交价要自己计算。Genesis API 没有免费套餐;订单簿包含在每月 $100 的 Pro 和 $200 的 Max 中。