加密货币订单簿 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.0004 | 1,100 | 1,100 | 1,099.56 |
| 1.0010 | 1,400 | 1,400 | 1,398.60 |
| 1.0018 | 2,600 | 2,600 | 2,595.33 |
| 1.0030 | 3,000 | 3,000 | 2,991.03 |
| 1.0050 | 6,000 | 1,900 | 1,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.0120 | 1.20% |
| 订单簿最优价 | 1.0004 → 1.0116 | 1.12% |
| 成交 $10,000 之后 | 1.0025 → 1.0095 | 0.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 中。