Genesis Arbitrage

Genesis Arbitrage · · 阅读约 4 分钟

API

API(应用程序编程接口)是一套规则,一个程序用它向另一个程序请求数据或操作:调用哪个 URL、发送什么内容、响应用什么格式返回。当价格、订单簿和资金费率需要由程序读取时,交易者就需要 API:机器人、电子表格或仪表盘都是如此。

请求示例

假设的示例:程序通过 Coin Search 接口向 Genesis API 请求 IRYS 币种资料。请求是 HTTP GET,密钥放在请求头中:

curl "https://api.genesisarbitrage.com/v1/coins/search?query=IRYS" \
  -H "X-API-Key: $GENESIS_API_KEY"

响应以 JSON 返回,部分字段已省略:

{
  "coin": "IRYS",
  "contracts": [
    {
      "address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
      "network": "BNB Smart Chain(BEP20)",
      "exchanges": ["MEXC", "Ourbit"]
    }
  ],
  "exchanges": {
    "MEXC": {
      "spot_price": 0.01329,
      "futures_price": 0.0133,
      "deposit": true,
      "withdraw": true
    }
  }
}

人工需要从交易所页面和区块浏览器中拼凑这些信息;程序一次响应就能拿到,并能立刻算出 MEXC 合约价格比现货高 (0.0133 − 0.01329) / 0.01329 × 100 ≈ 0.075%。

公开与私有交易所 API

交易所 API 分两部分。公开部分提供行情数据(报价、订单簿、成交),无需密钥。私有部分操作你的账户(余额、订单、成交历史),需要 API 密钥和请求签名。在 Binance 上,公开接口的安全类型是 NONE;其余接口都需要密钥和 signature 参数。

数据有两种送达方式。REST API 逐次应答每个请求:用你需要的筛选条件获取数据快照就是这样做的。WebSocket 保持连接打开,由服务器主动推送更新:Binance 就是这样实时推送成交和订单簿变化的。

数据 API:一次响应覆盖多个平台

交易所 API 只了解自己的平台。要比较某个币种在 20 家交易所的价格,程序需要 20 个连接,而且每家交易所都有各自的响应格式和限额。数据 API 会提前把这些平台合并起来。

API 类型返回内容访问方式
公开交易所 API单个交易所的报价、订单簿和成交无需密钥
私有交易所 API余额、订单、提现密钥和签名
Genesis API价差、订单簿、资金费率、DEX、链上、预测市场密钥,只读

对 Genesis API 的 /arbitrage/spot-spot 接口发一次请求,就能返回 20 多家 CEX 交易所现货市场之间已计算好的价差,并附带充币和提币标志。每个请求都是 HTTP GET,每个响应都是 JSON,各接口的参数和字段见文档。

另见:加密货币 API:类型与选择、文档中的快速开始、限流、课程:什么是加密货币 API。

常见问题

使用 API 需要 SDK 吗?

如果 API 使用 HTTP,任何 HTTP 客户端都可以。对 Genesis API 来说,curl、Python 的 requests 或 JavaScript 内置的 fetch 就够了。

可以通过 Genesis API 交易吗?

不可以。Genesis API 只提供数据。下单需在交易所手动完成,或通过交易所自己的 API 和密钥完成,风险自负。