Genesis Arbitrage

Genesis Arbitrage · · 阅读约 19 分钟

加密货币 API:加密货币行情数据 API 的类型,以及如何为交易选择

简而言之

  • 加密货币 API 为你的代码提供行情数据:价格、订单簿、资金费率、链上交易和预测市场报价。交易所 API 只覆盖一个平台,用密钥下单;行情数据 API 把多个平台合并为一种格式。
  • 选择 API 看九项标准:平台与链的覆盖范围、数据新鲜度、字段标准化、充币和提币状态、订单簿深度、rate limit、价格、文档以及数据使用条款。
  • Genesis API 是只读的 REST API:CEX、DEX、链上、预测市场和博彩公司套利(surebet)统一为一种 JSON 格式,套餐每月 $20 起。它不下单。

加密货币 API 是一种编程接口,代码通过它读取加密货币行情数据或向交易所发送订单:价格、订单簿、资金费率、区块链交易、预测市场报价。API 按覆盖范围分类:交易所 API 只了解一个平台,用密钥下单;行情数据 API 把多个平台合并为一种格式;链上 API 读取区块链。

加密货币 API 的类型

API 类型提供什么什么时候需要
交易所 API单个交易所的价格、订单簿和成交;用密钥下单在该交易所交易、获取某个交易对的成交流
行情数据 API多个交易所统一格式,现成的价差比较交易所、扫描器、提醒
链上 API交易、转账、余额、合约事件巨鲸、交易所资金流、解锁
DEX API池子价格与流动性、兑换、滑点CEX 上没有的代币、DEX – CEX 套利机会
衍生品数据资金费率、持仓量、期货价格资金费率套利、持仓偏向
预测市场与赔率 APIYES 和 NO 价格、订单簿、博彩公司赔率预测市场套利、surebet

交易所 API

加密货币交易所 API 是单个平台的接口,分为两部分。公开部分无需密钥即可提供行情数据:在 Binance 上,这些 endpoint 的安全类型是 NONE,GET /api/v3/ticker/price 返回交易对的价格。私有部分——订单、余额、交易历史——需要 API 密钥 和请求签名;在 Binance 上这是 TRADE 和 USER_DATA 类型(Binance 文档)。

这类 API 只覆盖一个交易所:要比较某个币在 20 个交易所的价格,你需要 20 个格式和限额各不相同的连接。

行情数据 API

行情数据 API 从多个交易所收集数据,将其标准化,并通过一次请求返回。响应中已经包含合并各平台所需的内容:跨交易所的价差、统一到同一周期的资金费率、按交易所划分的持仓量。

链上 API

链上 API 读取区块链:交易、代币转账、地址余额、智能合约事件。最底层是网络节点:每个以太坊客户端都使用 JSON-RPC,其中 eth_getBalance 以十六进制数返回以 wei 为单位的余额,eth_getLogs 返回符合过滤条件的合约事件。

节点并不知道哪些地址属于交易所、项目方或巨鲸;这些标签由索引器和链上分析服务添加。交易者需要哪些数据,见链上数据 API。

DEX API

DEX API 提供去中心化交易所的池子价格与流动性、兑换和滑点。兑换金额相对池子流动性越大,对价格的影响越大,因此 DEX – CEX 套利机会需要按你的交易规模计算滑点,新代币还需要查看代币税和蜜罐检查。更多内容见 DEX API。

衍生品数据:资金费率与持仓量

永续合约需要资金费率、持仓量(未平仓头寸的规模),以及现货旁边的期货价格。交易所每 8 小时、4 小时或 1 小时结算一次资金费率,因此要先把费率标准化到同一周期再比较。更多内容见资金费率 API 和持仓量 API。

预测市场与赔率 API

预测平台提供 YES 和 NO 合约的价格与订单簿。在 Polymarket 上,公开行情数据无需凭证,下单则需要身份验证和钱包签名(Polymarket 文档)。

这里的格式同样各不相同:Kalshi 的订单簿只包含买单,YES 卖价等于 $1 减去最优 NO 买价,所以 $0.56 的 NO 买价意味着 $0.44 的 YES 卖价(Kalshi 文档)。博彩公司赔率通过隐含概率与 YES 和 NO 价格对比——见 Polymarket API 与 Kalshi API 以及体育赔率 API。

REST 与 WebSocket

REST API 用按你的条件过滤的快照回应请求,更新则靠定时轮询获得。

WebSocket 保持连接不断开,服务器推送每一笔成交和订单簿变化。代价是你要无遗漏地处理数据流、断线后重连,并用快照加增量更新重建订单簿,而且 Kalshi 即使连接公开频道也要求身份验证。亚秒级反应需要 WebSocket;覆盖 20 多个交易所的扫描器和提醒通过 REST 即可运行。

Genesis API 只有 REST,没有 WebSocket,也没有 webhook:每个请求都是 GET,响应是 gzip 压缩的 JSON,数据每 meta.freshness_sec 秒刷新一次。重复发送不带过滤条件的完整数据集请求,并在 If-None-Match 中带上上一次的 ETag,若数据没有变化,就会返回没有响应体的 304,该响应不消耗配额。轮询的做法见 API 轮询最佳实践。

如何选择加密货币 API:清单

前六项标准可以在实际的 API 响应中看到;其余在文档和价格页中。

标准检查什么
平台与链的覆盖范围你用的交易所、现货和期货、DEX 和链
新鲜度与延迟响应中的生成时间、刷新步长、订单簿时效
字段标准化一致的代码、单位、百分比和时间
充币和提币状态按交易所和网络划分的充币、提币标志
订单簿深度你的交易规模对应的成交价
rate limit 与配额每秒请求数、每个周期的调用数、什么算一次调用
价格套餐还是按调用付费,超出限额会怎样
文档与 OpenAPI请求和响应示例、规范文件
数据使用条款能否基于这些数据构建自己的产品

覆盖范围与新鲜度

按你自己的清单检查覆盖范围:如果你的机器人使用 MEXC 和 Gate,缺少其中任何一个的 API 都不合适。数据新鲜度是快照生成后过去了多少秒;延迟是从交易所成交到你的代码的整条路径。在一分钟前的快照上,机器人看到的价差已经消失了。

字段标准化

同一个 BTC/USDT 交易对在各交易所 API 中写法不同:Binance 是 BTCUSDT,OKX 是 BTC-USDT(永续合约是 BTC-USDT-SWAP),Gate 是 BTC_USDT。Binance 以字符串返回价格(其文档示例为 "price": "4.00000200"),时间以毫秒为单位。你的代码要处理每一种差异。

行情数据 API 把字段统一为同一种形状,例如 Genesis API 文档中的这条 /funding/rates 记录:

{
  "coin": "TON",
  "exchanges": [
    {
      "exchange": "MEXC",
      "funding_pct": 0.02,
      "funding_8h_pct": 0.04,
      "next_payout": "00:00",
      "interval": "4h",
      "price": 2.184,
      "trade_url": "https://futures.mexc.com/exchange/TON_USDT"
    }
  ]
}

MEXC 对这个币每 4 小时结算一次资金费率,每个周期 0.02% 的费率在 funding_8h_pct 中标准化为 8 小时:0.02 × 8 / 4 = 0.04%(见资金费率)。

充币和提币状态

跨交易所现货套利机会只有在币能从买入交易所提出、并能充入卖出交易所时才可执行。在 Binance 上,网络状态来自 GET /sapi/v1/capital/config/getall,这是一个需要签名的 USER_DATA endpoint,需要你账户的 API 密钥(Binance 文档)。在 Genesis API 中,状态随每一行 Spot – Spot 数据返回,字段为 withdraw_enabled_buy 和 deposit_enabled_sell(Spot — Spot 文档)。

订单簿深度

最优价差反映订单簿顶部的差距,而一笔 $5,000 的交易会吃掉市场深度的好几个档位。在 Genesis API 文档中 /orderbooks/spreads/spot-futures 的示例里,BTC 价差在最优价格处是 0.031%,按 $5,000 吃穿订单簿后是 0.0202%。成交价格 endpoint 返回 $500–10,000 的成交价;更多内容见加密货币订单簿 API。

限额、价格与文档

限额的计算方式各不相同。在 Binance 上,每个 endpoint 都有权重,涉及多个交易对的请求权重更高,收到 429 后仍继续发送请求的 IP 会被封禁 2 分钟到 3 天(Binance 限额)。对数据 API,要查看调用配额、每秒 rate limit,以及什么算一次调用:在 Genesis API 中只有 200 响应消耗配额。

定价要么是带配额的套餐,要么按调用付费;要弄清超出限额会怎样——是返回 429 错误,还是产生额外费用。OpenAPI 规范是 API 的机器可读描述,可用于生成客户端和接入 AI 代理;使用条款则说明你能否基于这些数据构建产品,以及哪些内容不能转售。

一次请求完成检查

这个脚本拉取完整的 Spot – Spot 数据集(每个 Genesis API 套餐都可用),并用一次响应检查覆盖范围、快照时效和可转移机会的占比:

import os
import time

import requests

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

r = requests.get(BASE + "/arbitrage/spot-spot",
                 headers=HEADERS, timeout=15)
r.raise_for_status()
body = r.json()
rows, meta = body["data"], body["meta"]

# Coverage: which exchanges appear in the setups
venues = {x["exchange_buy"] for x in rows}
venues |= {x["exchange_sell"] for x in rows}
print("exchanges in response:", len(venues), sorted(venues))

# Freshness: snapshot age and the plan's refresh step
age = time.time() - meta["updated_at"]
print(f"snapshot {age:.0f} s old, plan step {meta['freshness_sec']} s")

# Transfer: withdrawals open on the buy side, deposits on the sell side
ok = [x for x in rows
      if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
print(f"transferable setups: {len(ok)} of {len(rows)}")

429 和 503 的重试逻辑来自 Genesis API 响应与错误中的 get_json 函数。然后通过 trade_url_buy 和 trade_url_sell 在交易所核对 3–5 个机会的价格和状态。

自己搭建,还是用现成的 API

如果只用一两个交易所并且要交易,基于它们的 API 自己写代码是自然的选择。对于有现货和期货的 20 个交易所,这意味着多达 40 个行情数据连接器:在 Binance 上,现货和 USDⓈ-M 期货是两套独立的 API,即 api.binance.com 和 fapi.binance.com。每个连接器都要处理 REST 快照、带重连的 WebSocket 数据流、各自的限额和交易对格式,此外还要合并:币要按合约和网络匹配,因为同一个代码在不同交易所可能是不同的代币。

任务基于交易所 API 自己写代码Genesis API
下单唯一的办法:交易所的交易 API不能,只读
某个交易对的每一笔成交交易所 WebSocket不能,每 60–5 秒一份快照
20 多个交易所的价差多达 40 个连接器加合并一次请求
充币和提币状态每个交易所一个 endpoint,Binance 需要密钥机会行中的字段
DEX、链上、预测市场节点、索引器、平台 API同一种 JSON 格式

两种方式可以结合:用数据 API 找机会,再在交易所手动开仓,或通过交易所的交易 API 使用没有提币权限的密钥开仓(见如何保护你的加密货币交易所账户)。带 Telegram 提醒的机器人,见 用 Python 写加密货币套利机器人。

Genesis API 的定位

Genesis API 是 Genesis Arbitrage 数据的 REST API:CEX、DEX、链上、预测市场和博彩公司套利(surebet)统一为一种 JSON 格式,密钥放在 X-API-Key 请求头中。它提供网站发布的同一批数据,共 35 多个 endpoint(规范中有 37 个操作),并且只读取数据。

数据示例 endpointAPI 套餐
CEX 价差/arbitrage/spot-spot全部
DEX 与跨链/arbitrage/dex-spotPro、Max
订单簿/orderbooks/execPro、Max
资金费率与 OI/funding/rates全部
链上/onchain/{section}Start、Pro、Max
预测市场与 surebet/predictions/arbitrageStart:exact、dutch;Pro、Max:llm、sport

覆盖范围:20 多个 CEX 交易所(Binance、OKX、Bybit、Bitget、MEXC、Gate、BingX、Kraken、WhiteBit、Coinbase、CoinW、edgeX、HTX、Hyperliquid 等),1000 多个币的资金费率统一到 8 小时,13 个以上期货交易所的持仓量。预测市场包括 Polymarket、Kalshi、Limitless、Predict.fun 和 Opinion;sport 模式在 13 个平台上构建博彩公司 surebet,仅限赛前。

套餐每月调用数每秒请求数新鲜度
Trial,$20/月500K160 秒
Start,$502M230 秒
Pro,$1005M510 秒
Max,$20010M155 秒

API 套餐与网站订阅是分开的;使用加密货币支付,3 个月享 9 折,6 个月享 8 折。超出限额时服务器返回 429 且不扣费,套餐之外的 endpoint 返回 403 plan_restricted。套餐对比见 Genesis API 价格;规则见套餐与限额。

文档的每个章节都有独立网址,包含参数、字段、curl 示例和 在线试用 表单。面向程序和 AI 代理,提供 OpenAPI 3.1 规范和 llms-full.txt 参考;配置方法见面向 AI 代理的 Genesis API。你可以基于 Genesis API 构建自己的服务、机器人和仪表盘;不能原样转售原始数据。

第一次请求——一个套餐、个人资料中的密钥,以及带 X-API-Key 的 GET——见快速开始,基础知识见课程 什么是加密货币 API,以及可以自动化什么。不写代码的话,同样的数据在网站表格和 Telegram 提醒中。

常见问题

有免费的加密货币 API 吗?

有:公开的交易所 API 免费且无需密钥即可提供价格、订单簿和成交(在 Binance 上是 NONE endpoint),但每个只覆盖一个交易所。Genesis API 没有免费套餐:Trial 每月 $20,含 500K 次调用。

使用加密货币 API 需要 SDK 吗?

对 REST API 来说,HTTP 客户端就够了:curl、Python 的 requests 或 JavaScript 的 fetch。Genesis API 没有官方 SDK,每个请求都是带一个请求头的 GET;你可以根据 OpenAPI 3.1 规范生成带类型的客户端。

可以通过行情数据 API 交易吗?

如果 API 是只读的,比如 Genesis API,就不行:它能找到机会,但不下单。订单要通过交易所下,手动下单,或通过其交易 API 使用密钥和签名下单(在 Binance 上是 TRADE endpoint),这不属于 Genesis API,风险自负。

如何通过 API 获取加密货币价格?

交易所的公开 endpoint 返回交易对在该交易所的价格:在 Binance 上是 GET /api/v3/ticker/price,价格以字符串形式返回。某个币在所有交易所的价格以及充币和提币状态,可通过 Genesis API 的 /coins/search?query=BTC 获取(见币种搜索)。