Genesis Arbitrage

Genesis Arbitrage · · 更新于 · 阅读约 7 分钟

Genesis API 快速入门:密钥、首次请求与限制

简而言之

  • Genesis API 是访问 Genesis Arbitrage 数据的 REST 接口:CEX 和 DEX 价差、订单簿、资金费率、跨链、链上资金流、预测市场以及 Genesis AI+ 信号。
  • 发出首次请求只需三步:选择套餐,在个人资料中获取密钥,然后带上 X-API-Key 请求头发送 GET 请求。
  • 您的套餐决定调用额度、每秒请求数和数据延迟:从 Trial 的 60 秒到 Max 的 5 秒。

Genesis API 以 REST API 的形式提供 Genesis Arbitrage 的数据:CEX 与 DEX 之间的价差、订单簿、资金费率、跨链、链上资金流、预测市场以及 Genesis AI+ 信号。网站上的每个工具都有对应的独立端点,并使用统一的 JSON 格式。发出首次请求只需要一个 API 套餐、一个密钥和一个 HTTP 请求头,无需 SDK,任何带 HTTP 客户端的语言都可以使用。

Genesis API 快速入门:密钥、首次请求与限制
在 Genesis Arbitrage 中的显示效果

API 涵盖的内容

端点与网站的各个板块一一对应:

数据集在 Genesis API 页面中介绍;每个端点的参数和字段见 文档。

套餐与限制

API 有独立的套餐,与网站订阅分开:Trial、Start、Pro 和 Max。它们在调用额度、每秒请求数限制和数据新鲜度上各不相同。

API 套餐每月调用次数数据新鲜度
Trial500K60 秒
Start2M30 秒
Pro5M10 秒
Max10M5 秒

Trial 每月 $20,Max 允许每秒 15 次请求。不属于您套餐的端点会返回 403 错误,错误码为 plan_restricted。超出限制的请求不计费:请等待新周期或升级套餐。只有 200 响应会消耗额度:错误和 304 响应免费。价格和完整对比见 Genesis API 价格 页面。

您的首次请求

  1. 选择套餐

    在 Genesis API 价格 页面选择套餐和周期,然后点击“订阅”。支付方式与网站订阅一样,使用加密货币。如果已有其他 API 套餐处于有效状态,支付新套餐会将其替换,剩余部分作废,网站会事先提醒您。

  2. 获取密钥

    在个人资料的 Genesis API 板块中点击“获取密钥”。“你的 API 密钥”窗口中会出现一个 gns_live_… 密钥,点击“复制”并保存好。它只显示一次。

  3. 发出请求

    发送普通的 HTTP GET 请求,并在 X-API-Key 请求头中传入密钥。基础 URL 为 https://api.genesisarbitrage.com/v1。第一个请求建议使用 /account/usage 端点,它会显示您的套餐和剩余额度。

  4. 解析响应

    成功的响应采用统一的外层结构:一个 data 数组和一个 meta 块。如果出现问题,请查看下面的错误表。

curl 示例:

curl "https://api.genesisarbitrage.com/v1/account/usage" \
  -H "X-API-Key: gns_live_…"

文档中有“在线试用”表单:粘贴您的密钥,点击“发送请求”,即可在页面上看到精简后的响应。密钥只保存在您的浏览器中。

响应格式

错误与限制

状态码含义
401密钥缺失、无效或已被撤销
403该端点不属于您的套餐
404未找到端点或资源
429超出速率限制,请查看 X-RateLimit 和 Retry-After 请求头
500内部错误,请稍后重试
503数据正在重建,请几秒后重试,参见 Retry-After

每个响应中的 X-RateLimit 请求头会显示您每秒请求数的限制、当前窗口剩余的请求数以及窗口重置的时间。X-Quota 请求头显示该周期的调用额度、剩余额度及重置时间。每个响应还带有 X-Request-Id:联系支持时,请附上它,以及 UTC 请求时间、端点和状态码。切勿发送密钥本身。

下一步

常见问题

Genesis API 与免费的交易所 API 有什么区别?

交易所 API 返回的是单个交易所的订单簿和行情。Genesis API 返回的是数十个交易所和网络之间已计算好的价差、充币和提币标记,以及剔除了低流动性交易对的数据。

超出限制会怎样?

服务器会返回 429,并带有 X-RateLimit 和 Retry-After 请求头。多余的请求不计费。

可以更换我的 API 套餐吗?

可以。新套餐在支付后立即生效:新的限制和数据新鲜度马上适用,调用额度从零开始计算,原套餐的剩余部分作废。续订同一套餐则会在当前期限上增加天数。

可以在我自己的产品中使用这些数据吗?

可以,您可以基于 Genesis API 构建自己的服务、机器人和仪表盘。但不得将原始数据原样转售。