Genesis API 文档

接入所需的一切:认证、限额、接口和响应结构。

文档套餐与限额

套餐与限额

限额由你的套餐决定。当前状态可随时在 /account/usage 以及每个响应的请求头中查看。

TrialStartProMax
每月调用次数500K2M5M10M
每秒请求数12515
数据新鲜度60 秒30 秒10 秒5 秒

超出套餐范围的接口会返回 403 及 plan_restricted 代码。超出限额的请求不会计费。

只有 200 响应才计为一次调用。304(未修改)响应以及 4xx/5xx 错误不占用你的额度,但仍计入每秒请求数限制。

下载量限制为每个密钥每 10 秒 60 MB 压缩数据。按您套餐的新鲜度轮询所有数据集完全够用;小于 64 KB 的响应不计入。超出限制时返回 429 download_limited,直到窗口结束。可通过 If-None-Match、筛选参数和 coin 参数节省流量。

限流请求头

请求头说明
X-RateLimit-Limit你的套餐每秒请求数上限
X-RateLimit-Remaining当前窗口内剩余的请求数
X-RateLimit-Reset窗口重置的 Unix 时间
X-Quota-Limit当前 30 天周期的调用额度
X-Quota-Remaining本周期剩余调用次数
X-Quota-Reset额度重置的 Unix 时间
Retry-After重试前需等待的秒数(用于 429 和 503)