Genesis Arbitrage

Genesis Arbitrage · · 阅读约 5 分钟

数据新鲜度

数据新鲜度是数据送达你手中时的“年龄”:从数据生成到响应抵达,过去了多少秒。在套利中,它决定价差是否还存在:按一分钟前的报价算出的交易对,可能在你的请求到达之前就已经关闭。

按 Genesis API 套餐划分的新鲜度

Genesis Arbitrage 核心每秒刷新一次数据,而 API 输出的更新频率由你的 Genesis API 套餐决定。每个响应都带有套餐对应的 meta.freshness_sec 和数据生成时间 meta.updated_at(响应格式)。

套餐freshness_sec最快轮询频率
Trial60每 60 秒一次
Start30每 30 秒一次
Pro10每 10 秒一次
Max5每 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 而不触发限制、自动化风险、订单簿。

常见问题

新鲜度与延迟有什么区别?

延迟是从交易所事件到你的代码的整条路径:交易所发布、采集、计算、传输,以及你的轮询间隔。新鲜度则是你能在响应中看到的那一部分:快照是多久前生成的。服务器可能在不到一秒内作答,返回的却仍是一分钟前的快照。