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,500K | 60 秒 | 43,200 | 11 |
| Start,2M | 30 秒 | 86,400 | 23 |
| Pro,5M | 10 秒 | 259,200 | 19 |
| Max,10M | 5 秒 | 518,400 | 19 |
这个计算没有计入 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 秒。更频繁地轮询只会返回相同的数据。