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 客户端的语言都可以使用。

API 涵盖的内容
端点与网站的各个板块一一对应:
- 套利:Spot – Spot、Spot – Futures、Futures – Futures、DEX – Spot、DEX – Futures、Crosschain 和股票代币套利。
- 订单簿:各市场按指定数量的成交价格、套利行的“订单簿 Δ”、市场订单簿、成交历史以及 DEX 滑点(API Pro 和 Max 套餐提供)。
- 预测市场:预测套利和平台状态;分析、聪明钱、大额交易和交易者排行榜由 API Pro 和 Max 套餐提供。
- 资金费率:所有交易所的资金费率、资金费率价差,以及历史资金费率分析(API Pro 和 Max 套餐提供)。
- 市场:Fair – Last、CEX Pumps – Dumps、DEX Dumps、OI 追踪。
- 链上:大额转账、CEX 资金流、增发与跨链桥、团队钱包、Perp. DEX 持仓、解锁、领取、黑客事件;API Pro 和 Max 套餐还提供 DEX 概览、分析和币种页面。
- AI 与搜索:Genesis AI+ 信号和完整的币种卡片。
- 账户:您的密钥状态:套餐、已用额度和限制。
数据集在 Genesis API 页面中介绍;每个端点的参数和字段见 文档。
套餐与限制
API 有独立的套餐,与网站订阅分开:Trial、Start、Pro 和 Max。它们在调用额度、每秒请求数限制和数据新鲜度上各不相同。
| API 套餐 | 每月调用次数 | 数据新鲜度 |
|---|---|---|
| Trial | 500K | 60 秒 |
| Start | 2M | 30 秒 |
| Pro | 5M | 10 秒 |
| Max | 10M | 5 秒 |
Trial 每月 $20,Max 允许每秒 15 次请求。不属于您套餐的端点会返回 403 错误,错误码为 plan_restricted。超出限制的请求不计费:请等待新周期或升级套餐。只有 200 响应会消耗额度:错误和 304 响应免费。价格和完整对比见 Genesis API 价格 页面。
您的首次请求
选择套餐
在 Genesis API 价格 页面选择套餐和周期,然后点击“订阅”。支付方式与网站订阅一样,使用加密货币。如果已有其他 API 套餐处于有效状态,支付新套餐会将其替换,剩余部分作废,网站会事先提醒您。
获取密钥
在个人资料的 Genesis API 板块中点击“获取密钥”。“你的 API 密钥”窗口中会出现一个
gns_live_…密钥,点击“复制”并保存好。它只显示一次。发出请求
发送普通的 HTTP GET 请求,并在
X-API-Key请求头中传入密钥。基础 URL 为https://api.genesisarbitrage.com/v1。第一个请求建议使用/account/usage端点,它会显示您的套餐和剩余额度。解析响应
成功的响应采用统一的外层结构:一个
data数组和一个meta块。如果出现问题,请查看下面的错误表。
curl 示例:
curl "https://api.genesisarbitrage.com/v1/account/usage" \
-H "X-API-Key: gns_live_…"
文档中有“在线试用”表单:粘贴您的密钥,点击“发送请求”,即可在页面上看到精简后的响应。密钥只保存在您的浏览器中。
响应格式
data根据端点不同,包含数组或对象。meta包含条目数量、数据最后更新时间、您套餐的延迟秒数以及您的套餐。- 空值为
null。时间为 Unix 秒。 - 价差和费率为百分比:0.92 表示 0.92%。
- 所有筛选参数都是可选的:不带参数时,端点返回完整数据集。
错误与限制
| 状态码 | 含义 |
|---|---|
| 401 | 密钥缺失、无效或已被撤销 |
| 403 | 该端点不属于您的套餐 |
| 404 | 未找到端点或资源 |
| 429 | 超出速率限制,请查看 X-RateLimit 和 Retry-After 请求头 |
| 500 | 内部错误,请稍后重试 |
| 503 | 数据正在重建,请几秒后重试,参见 Retry-After |
每个响应中的 X-RateLimit 请求头会显示您每秒请求数的限制、当前窗口剩余的请求数以及窗口重置的时间。X-Quota 请求头显示该周期的调用额度、剩余额度及重置时间。每个响应还带有 X-Request-Id:联系支持时,请附上它,以及 UTC 请求时间、端点和状态码。切勿发送密钥本身。
下一步
- API 密钥:获取、保存、重新生成:密钥在个人资料中的位置以及如何保护它。
- 限制:额度、每秒请求数、新鲜度:如何避免收到 429 响应。
- 响应与错误:JSON、ETag、HTTP 状态码:响应外层结构、304 和重试。
- 按分组查看端点:套利、订单簿、资金费率、市场与 AI 信号、链上、预测市场与博彩套利。
- 面向 AI 智能体的 Genesis API:OpenAPI 规范、llms.txt 和 function calling。
常见问题
Genesis API 与免费的交易所 API 有什么区别?
交易所 API 返回的是单个交易所的订单簿和行情。Genesis API 返回的是数十个交易所和网络之间已计算好的价差、充币和提币标记,以及剔除了低流动性交易对的数据。
超出限制会怎样?
服务器会返回 429,并带有 X-RateLimit 和 Retry-After 请求头。多余的请求不计费。
可以更换我的 API 套餐吗?
可以。新套餐在支付后立即生效:新的限制和数据新鲜度马上适用,调用额度从零开始计算,原套餐的剩余部分作废。续订同一套餐则会在当前期限上增加天数。
可以在我自己的产品中使用这些数据吗?
可以,您可以基于 Genesis API 构建自己的服务、机器人和仪表盘。但不得将原始数据原样转售。