跳到正文

速率限制

每次调用都计入限制,按客户统计(合并您的所有 API 密钥),按自然分钟计算。以下是当前生效的限制。

GET /account, GET /checkers, GET /orders, GET /orders/{id}
每分钟 60 次
GET /orders/{id}/results
每分钟 30 次
POST /uploads
每分钟 10 次
POST /estimates
每分钟 10 次
使用 POST /orders 的新订单
每分钟 10 次
来自 API、同时未完成的任务分片
同时 20 个
使用错误 API 密钥的请求,按 IP 地址计
每分钟 20 次

响应可以告诉您什么

这些标头可能不存在,例如在重复下单时,因此您的代码不要强制要求它们。

  • RateLimit-Limit:此类调用的限制。
  • RateLimit-Remaining:本分钟剩余的次数。
  • RateLimit-Reset:距离重新开始计数的秒数。

超出限制时

您会收到 429 rate_limited 和 Retry-After(需要等待的秒数)。此请求没有执行任何操作,也没有扣费。请等待相应时间后再次发送;如果是下单,请使用相同的 Idempotency-Key。

重试

重复已经下达的订单,或重复已通过这些限制但丢失了响应的订单,不计入下单限制,因此安全重试不会因为是重试而被拒绝。所有下单请求同时还受另一个上限约束:下单限制的六倍,且至少为每分钟 60 次。

未完成的订单

一个大订单由多个任务分片组成,每 1,000,000 条一个。超过未完成分片的限制时,您会收到 429 too_many_open_orders:请等待部分分片完成。当您没有其他未完成的内容时,单个大订单可以超过此限制。

需要更高限额?

请联系我们,并说明您正在构建的内容。

本页内容