延迟(latency)
延迟(latency)是市场中发生某个事件,到相关数据抵达你的代码之间的时间。假设示例:某笔成交在交易所于 12:00:00 出现,你的脚本在 12:00:12 收到新价格,延迟为 12 秒。
延迟由什么构成
| 环节 | 增加时间的因素 |
|---|---|
| 交易所 | 在其 API 中发布成交或订单簿变化 |
| 采集 | 通过 WebSocket 或 REST 接收数据、重连 |
| 计算 | 匹配交易所、重新计算价差和订单簿 |
| 交付 | 套餐的输出刷新步长,以及到你服务器的网络 |
| 你的代码 | 轮询间隔和响应处理 |
其中一些环节体现在 Genesis API 的响应字段中。meta.updated_at 是快照的生成时间,meta.freshness_sec 是你的套餐的输出延迟:60、30、10 或 5 秒。订单簿有自己的标记:age_sec 是订单簿的存在时长,stale 标出超过 30 秒的订单簿;订单簿比交易所滞后 5–20 秒(文档中的市场订单簿)。
套利中的过期价格
假设示例:15 秒前的快照显示某币种在交易所 A 为 $10.00,在交易所 B 为 $10.12。
| 时刻 | A 上的价格 | B 上的价格 | 价差 |
|---|---|---|---|
| 快照中 | $10.00 | $10.12 | 1.2% |
| 交易所当前 | $10.00 | $10.03 | 0.3% |
两笔交易各付 0.1% 的吃单手续费,共消耗 0.2%,所以快照里的 1.2% 只剩下 0.1%。延迟越高,机器人看到交易所里早已消失的价差的次数就越多。
响应时间与数据新鲜度
服务器响应时间和数据新鲜度(即快照生成了多久)是两个不同的数字。假设示例:响应在 0.2 秒内到达,但其中的快照已有 9 秒。两者都可以测量:
import os
import time
import requests
r = requests.get(
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params={"coin": "BTC"},
timeout=10,
)
r.raise_for_status()
meta = r.json()["meta"]
# 响应时间:从发出请求到解析完响应头
print("response time:", round(r.elapsed.total_seconds(), 2), "s")
# 数据时长:自快照生成以来经过的时间
print("data age:", round(time.time() - meta["updated_at"]), "s")
数据时长是按你服务器的时钟计算的:如果时钟漂移,误差会进入结果,所以请保持时间同步(NTP)。
另见:API 轮询、WebSocket、响应格式、自动化的风险:过期数据、错误、密钥。
常见问题
Genesis API 的延迟是多少?
输出在 Trial 上每 60 秒刷新,Start 为 30 秒,Pro 为 10 秒,Max 为 5 秒;你的密钥的确切值通过 meta.freshness_sec 返回。你的轮询间隔和网络会在此基础上增加延迟。