数据新鲜度
数据新鲜度是数据送达你手中时的“年龄”:从数据生成到响应抵达,过去了多少秒。在套利中,它决定价差是否还存在:按一分钟前的报价算出的交易对,可能在你的请求到达之前就已经关闭。
按 Genesis API 套餐划分的新鲜度
Genesis Arbitrage 核心每秒刷新一次数据,而 API 输出的更新频率由你的 Genesis API 套餐决定。每个响应都带有套餐对应的 meta.freshness_sec 和数据生成时间 meta.updated_at(响应格式)。
| 套餐 | freshness_sec | 最快轮询频率 |
|---|---|---|
| Trial | 60 | 每 60 秒一次 |
| Start | 30 | 每 30 秒一次 |
| Pro | 10 | 每 10 秒一次 |
| Max | 5 | 每 5 秒一次 |
轮询频率高于 freshness_sec 只会返回同一份快照。在 If-None-Match 中带上上一次响应的 ETag:若数据没有变化,API 返回不带响应体的 304,且该响应不占用配额(ETag 与 If-None-Match、API 轮询)。数据重建期间会返回 503 snapshot_not_ready;请在 Retry-After 秒后重试。
订单簿与交易所端的延迟
订单簿有自己的时间。在 /orderbooks/book 和 /orderbooks/coin/{coin} 中,每个订单簿都有 book_ts(订单簿时间)、age_sec(以秒计的年龄)和 stale,订单簿超过 30 秒时 stale 为 true。订单簿比交易所滞后 5–20 秒(市场订单簿)。
age_sec 在生成响应时计算,因此收到数据的那一刻用 now − book_ts 更准确。对于预测市场,/predictions/platforms 按平台显示新鲜度:quotes_at 是其最新报价的时间,full_scan_at 是最近一次完整扫描的时间。
在代码中检查
订单簿包含在 Pro 和 Max 套餐中,而 meta 的检查方式对所有 endpoint 都一样。
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/orderbooks/book"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def get_json(params, tries=3):
for _ in range(tries):
r = requests.get(URL, headers=HEADERS, params=params,
timeout=10)
if r.status_code in (429, 503): # 触发限流或正在重建
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
return r.json()
raise RuntimeError("data not ready")
params = {"exchange": "Binance", "market": "spot", "coin": "BTC"}
body = get_json(params)
now = time.time()
meta = body["meta"]
print(f"快照年龄 {now - meta['updated_at']:.0f} 秒,"
f"套餐新鲜度 {meta['freshness_sec']} 秒")
book = body["data"]
ts = book["book_ts"]
if book["stale"] or ts is None or now - ts > 30:
print("订单簿已过期,跳过该信号")
另请参阅:Genesis API 限制、如何轮询 API 而不触发限制、自动化风险、订单簿。
常见问题
新鲜度与延迟有什么区别?
延迟是从交易所事件到你的代码的整条路径:交易所发布、采集、计算、传输,以及你的轮询间隔。新鲜度则是你能在响应中看到的那一部分:快照是多久前生成的。服务器可能在不到一秒内作答,返回的却仍是一分钟前的快照。