Genesis Arbitrage

Genesis Arbitrage · · 阅读约 4 分钟

API 轮询

API 轮询是按计划重复发送请求来获取最新数据:客户端每隔 N 秒向服务器询问有什么变化。机器人和看板通过 REST API 就是这样工作的,REST API 不会主动推送任何内容,每次轮询都是一个普通的 HTTP GET。

间隔与数据新鲜度

轮询得比数据更新还快没有意义:服务器返回的是同一份快照。在 Genesis API 中,数据新鲜度取决于套餐:输出在 Trial 上每 60 秒刷新,Start 为 30 秒,Pro 为 10 秒,Max 为 5 秒,该值通过 meta.freshness_sec 字段返回。快照的生成时间在 meta.updated_at 中;连续两次响应里出现相同的值,说明第二次请求是浪费的。

假设示例:在 Trial 上,某机器人每 10 秒轮询一个 endpoint。每分钟六次请求中只有一次带来新数据;其余五次重复同一份快照,除非机器人发送 If-None-Match,否则它们仍会占用额度。

import os
import time
import requests

URL = "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}

while True:
    r = requests.get(URL, headers=HEADERS,
                     params={"min_spread": 1}, timeout=10)
    if r.status_code in (429, 503):
        time.sleep(int(r.headers.get("Retry-After", "5")))
        continue
    r.raise_for_status()
    meta = r.json()["meta"]
    print("pairs:", meta["count"], "snapshot:", meta["updated_at"])
    # 比套餐的刷新步长更频繁地轮询没有意义
    time.sleep(meta["freshness_sec"])

轮询会用掉多少次调用

每 10 秒轮询一个 endpoint:2,592,000 ÷ 10 = 30 天内 259,200 次调用。Genesis API 的额度同样按 30 天计算。

套餐与额度间隔 = 新鲜度每个 endpoint 的调用次数额度内可轮询的 endpoint
Trial,500K60 秒43,20011
Start,2M30 秒86,40023
Pro,5M10 秒259,20019
Max,10M5 秒518,40019

这个计算没有计入 304 响应。在 Pro 上,19 个 endpoint 每 10 秒轮询一次,平均每秒 1.9 个请求,而限制是 5。请把请求分散开:一次性发出 19 个请求会超出限制,服务器会返回 HTTP 429。

轮询、WebSocket 与 webhook

方式谁发起传输适用场景
轮询客户端,按计划按已知步长更新的数据;任何 HTTP 客户端都能用
WebSocket服务器,通过已建立的连接持续的变化流:交易所订单簿和成交
Webhook服务器,向你的 URL 发请求低频事件,前提是你有公网 HTTPS endpoint

Genesis API 没有 WebSocket 和 webhook:数据通过 REST 提供,新鲜度由套餐决定。按 meta.freshness_sec 轮询是使用它的标准方式;减少流量和调用次数的方法见如何在不触发限制的情况下轮询 API。

另见:限流、文档中的套餐与限额、响应格式、Genesis API 限制。

常见问题

我应该多久轮询一次 Genesis API?

不要比套餐的 meta.freshness_sec 更频繁:Trial 每 60 秒,Start 每 30 秒,Pro 每 10 秒,Max 每 5 秒。更频繁地轮询只会返回相同的数据。