什么是加密货币 API,可以自动化什么
简而言之
- 加密货币 API 是程序用来请求市场数据并获得 JSON 响应的编程接口:你在网站表格里看到的价差,会以
exchange_buy、exchange_sell和spread_pct字段的形式返回。 - 交易所 API 覆盖单个交易所的数据和账户,市场数据 API 把多家交易所合并为统一格式,链上 API 读取区块链。Genesis API 是只读的市场数据 API。
- 借助 API,交易者可以自动化价差、资金费率和持仓量监控、提醒、信号日志、仪表盘以及历史数据研究。
- 没有经验时,下单和提币应保持手动:数据快照滞后于交易所,代码中的错误会在每个周期重复出现。
加密货币 API 是你的代码用来请求加密货币市场数据,并获得可直接处理的结果的编程接口:价格、交易所之间的价差、资金费率、持仓量。人在表格里读这些数字;程序则以 JSON 字段接收,可以立刻与阈值比较、写入日志或发送提醒。通用定义见术语表条目 API。
请求与响应
使用 API 就是交换两条消息:程序向某个地址发送请求,服务器返回响应。最短的示例是 Genesis API 的状态检查,无需密钥:
curl "https://api.genesisarbitrage.com/health"
{"ok":true}
curl 是用于发送 HTTP 请求的命令行程序;用 curl --version 可以确认是否已安装。数据请求需要 API 密钥,服务器用这串字符识别你的账户和套餐。示意示例:查询 FUEL 币的 Spot – Spot 交易对,密钥取自环境变量 GENESIS_API_KEY:
URL="https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
curl "$URL?coin=FUEL" -H "X-API-Key: $GENESIS_API_KEY"
{
"success": true,
"data": [
{
"coin": "FUEL",
"exchange_buy": "ByBit",
"exchange_sell": "Gate",
"price_buy": 0.0007029,
"price_sell": 0.0007037,
"spread_pct": 0.11,
"withdraw_enabled_buy": true,
"deposit_enabled_sell": true,
…
}
],
"meta": {
"count": 1,
"updated_at": 1794675861,
"freshness_sec": 60,
"plan": "trial"
}
}
响应中只有一个交易对:在 ByBit 以 0.0007029 买入 FUEL,在 Gate 以 0.0007037 卖出。价差已在 spread_pct 中算好:(0.0007037 − 0.0007029) / 0.0007029 × 100 ≈ 0.11%。withdraw_enabled_buy 和 deposit_enabled_sell 标志表示 ByBit 的提币和 Gate 的充币均已开放,meta.updated_at 则说明快照的生成时间。Spot – Spot 表格显示的是同样的数字,每个字段都在文档的 Spot — Spot 部分有说明。
请求地址由基础 URL、endpoint 路径和参数组成,而密钥通过 X-API-Key 请求头单独发送。第 2 课会逐一拆解请求的每个部分,介绍状态码和 JSON 读取方式,并演示如何设置密钥变量。
这种“发送请求、返回数据快照”的交互方式称为 REST API。要获得新数据,需要再次发送请求:Genesis API 每隔 meta.freshness_sec 秒刷新一次输出,Trial 为 60 秒,Max 低至 5 秒。交易所还提供第二种通道 WebSocket:连接保持打开,服务器在成交和订单簿变化发生时立即推送,例如 Binance 数据流。Genesis API 没有 WebSocket。
加密货币 API 的类型
加密货币 API 的区别在于数据来源,以及能通过它做什么:
- 交易所 API:访问单个交易所的数据和账户。交易所公开提供价格、订单簿和成交记录,而余额、订单和交易历史需要密钥和签名请求。Binance 将其划分为安全类型:公开市场数据为
NONE,下单和撤单为TRADE,账户详情为USER_DATA(Binance 文档)。 - 市场数据 API:多家交易所和多条网络,统一格式。它提供需要跨交易所合并才能得到的数据:交易所之间的价差、统一到同一周期的资金费率、按交易所划分的持仓量。Genesis API 属于这一类,并且只读取数据。
- 链上 API:区块链数据,例如交易、代币转账和地址余额。“交易所”“项目方”“巨鲸”这类标签来自建立在网络数据之上的分析服务。
六类 API 的对比、REST 与 WebSocket 的区别以及九项选择清单,见综述 加密货币 API 的类型与选择方法。
交易者可以自动化什么
把你按固定规则重复做的事交给程序:打开表格、把数字与阈值比较、记下结果。程序按计划执行,夜间也不会漏掉。
| 任务 | 程序做什么 | Genesis API 数据 |
|---|---|---|
| 价差监控 | 筛选高于阈值且充币、提币均开放的交易对 | /arbitrage/spot-spot、/arbitrage/spot-futures |
| 资金费率 | 比较统一到 8 小时的各交易所费率 | /funding/rates、/funding/spread |
| 持仓量 | 捕捉 5 分钟到 1 小时内 OI 的急剧变化 | /market/open-interest |
| 提醒 | 满足条件时通过 Telegram 给你发消息 | 任意数据 endpoint |
| 日志 | 把发现的每个交易对连同时间戳保存下来 | 响应和 meta.updated_at |
| 仪表盘 | 在你自己的页面上显示你的列和阈值 | 来自你服务器的请求 |
| 历史研究 | 在过往数据中寻找规律 | /funding/analytics/daily(Pro、Max) |
提醒是常见的第一个项目:程序查询 endpoint 的频率不高于 meta.freshness_sec,当价差或费率越过你的阈值时给你发消息。不写代码的话,可以使用网站 Pro 套餐中的 Genesis Arbitrage Telegram 提醒获得类似信号。
日志能在投入资金之前检验一个想法。示意示例:机器人每 30 秒记录一次价差 1% 及以上的交易对,每天就是 86,400 / 30 = 2,880 份快照。从中可以看出有多少交易对持续超过一分钟,又有多少在下一次轮询时已经消失。
在历史数据方面,Genesis API 提供资金费率分析(覆盖 13 家交易所、最长一年的每日已结算资金费用合计)和订单簿滑点历史,两者都包含在 Pro 和 Max 套餐中。Genesis API 没有历史 K 线:K 线由交易所 API 提供,在 Binance 上通过 GET /api/v3/klines,每次请求最多 1,000 根(Binance 文档)。跨交易所价差的历史,则由你的程序根据日志中的快照自行构建。
没有经验时不要自动化的环节
有两项操作一旦出错代价很高:下单和提币。
下单
通过交易所交易 API 下单的机器人,运行多少次就可能出错多少次:入场条件中的一个错误,加上每 10 秒轮询一次,每小时会产生 3,600 / 10 = 360 个订单。数据也有滞后:Genesis API 的快照按套餐每 60 到 5 秒刷新一次,订单簿比交易所滞后 5–20 秒,价差可能在这段时间内收窄。Genesis API 不下单:它负责找出交易对,交易由你自己在交易所中开仓。
提币
带有提币权限的交易所密钥,会让任何拿到它的人都能把资金转出账户,因此这类密钥一旦泄露,可能损失全部余额。只读取数据或只交易的机器人不需要这项权限。在 Binance 上,新建的 API 密钥默认甚至不能交易:交易权限需要单独开启。
网站、交易所 API 还是 Genesis API
| 任务 | 更合适的选择 | 原因 |
|---|---|---|
| 浏览交易对和图表 | Genesis Arbitrage 网站 | 表格和筛选器,无需代码 |
| 不编程也要信号 | 网站的 Telegram 提醒 | 在界面中设置阈值 |
| 在 20 多家交易所上用自己的规则 | Genesis API | 价差已计算,格式统一 |
| 订单、余额、提币 | 交易所 API | 只有交易所接受订单 |
| 实时获取每一笔成交 | 交易所 WebSocket | Genesis API 每 60–5 秒提供一次快照 |
| 历史 K 线 | 交易所 API | Genesis API 没有 K 线 |
| 13 家交易所的资金费率历史 | Genesis API,Pro 和 Max | 最长一年的每日合计,格式统一 |
一个实用的起步方案:Genesis API 找出交易对,你的机器人发送提醒,你先在交易所查看订单簿,再自己开仓。Genesis API 套餐从每月 $20 的 Trial(500K 次调用,60 秒新鲜度)到 $200 的 Max(10M 次调用,5 秒),没有免费套餐。可在 Genesis API 价格页面对比。
学完本课程需要准备什么
- Genesis API 密钥:在价格页选择套餐,然后在个人资料中点击“获取密钥”按钮;具体步骤见 Genesis API 快速开始。把密钥保存在环境变量
GENESIS_API_KEY中,切勿放进请求 URL。 - 在终端中发送第一批请求用的 curl。
- Python 3.10+ 和
requests库(pip install requests),用于第 2 课和第 4 课的脚本。 - Genesis API 文档:每个 endpoint 都有参数、字段、curl 示例,以及可直接在页面上发送请求的“在线试用”表单。
各课内容环环相扣:
- 第 2 课:第一次请求,包括地址、请求头、状态码和 JSON;
- 第 3 课:哪些数据服务于哪些决策,从价差和订单簿到资金费率和链上资金流;
- 第 4 课:用 Python 编写价差和资金费率监控;
- 第 5 课:自动化风险,包括过期数据、错误、密钥和 AI 智能体。
亲自试一试
不带密钥发送请求
在终端中运行
curl "https://api.genesisarbitrage.com/health"。返回{"ok":true}说明请求已送达,服务器以 JSON 作出了回应。把表格与字段对应起来
打开 Spot – Spot 表格和文档中的 Spot — Spot 部分。找到交易所、价格、价差和转账状态对应的字段:
exchange_buy、price_sell、spread_pct、withdraw_enabled_buy。列出你的日常任务
选出你每天做的三件事,用上面的表格逐一标注:网站、Genesis API 还是交易所 API。
为一项任务找到 endpoint
对于适合用 Genesis API 完成的任务,在文档中找到对应的 endpoint,并记下需要的参数,例如
coin和min_spread。你将在第 2 课中发送这个请求。