Genesis Arbitrage

Genesis Arbitrage · · 阅读约 12 分钟

什么是加密货币 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 的对比、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只有交易所接受订单
实时获取每一笔成交交易所 WebSocketGenesis API 每 60–5 秒提供一次快照
历史 K 线交易所 APIGenesis API 没有 K 线
13 家交易所的资金费率历史Genesis API,Pro 和 Max最长一年的每日合计,格式统一

一个实用的起步方案:Genesis API 找出交易对,你的机器人发送提醒,你先在交易所查看订单簿,再自己开仓。Genesis API 套餐从每月 $20 的 Trial(500K 次调用,60 秒新鲜度)到 $200 的 Max(10M 次调用,5 秒),没有免费套餐。可在 Genesis API 价格页面对比。

学完本课程需要准备什么

各课内容环环相扣:

亲自试一试

  1. 不带密钥发送请求

    在终端中运行 curl "https://api.genesisarbitrage.com/health"。返回 {"ok":true} 说明请求已送达,服务器以 JSON 作出了回应。

  2. 把表格与字段对应起来

    打开 Spot – Spot 表格和文档中的 Spot — Spot 部分。找到交易所、价格、价差和转账状态对应的字段:exchange_buy、price_sell、spread_pct、withdraw_enabled_buy。

  3. 列出你的日常任务

    选出你每天做的三件事,用上面的表格逐一标注:网站、Genesis API 还是交易所 API。

  4. 为一项任务找到 endpoint

    对于适合用 Genesis API 完成的任务,在文档中找到对应的 endpoint,并记下需要的参数,例如 coin 和 min_spread。你将在第 2 课中发送这个请求。