加密货币 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 套利机会 |
| 衍生品数据 | 资金费率、持仓量、期货价格 | 资金费率套利、持仓偏向 |
| 预测市场与赔率 API | YES 和 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 个操作),并且只读取数据。
| 数据 | 示例 endpoint | API 套餐 |
|---|---|---|
| CEX 价差 | /arbitrage/spot-spot | 全部 |
| DEX 与跨链 | /arbitrage/dex-spot | Pro、Max |
| 订单簿 | /orderbooks/exec | Pro、Max |
| 资金费率与 OI | /funding/rates | 全部 |
| 链上 | /onchain/{section} | Start、Pro、Max |
| 预测市场与 surebet | /predictions/arbitrage | Start: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/月 | 500K | 1 | 60 秒 |
| Start,$50 | 2M | 2 | 30 秒 |
| Pro,$100 | 5M | 5 | 10 秒 |
| Max,$200 | 10M | 15 | 5 秒 |
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 获取(见币种搜索)。