Rate limits
Generous limits for automation, strict limits for anonymous traffic.
Limits#
| Surface | Limit |
|---|---|
| API keys | 600 requests per minute per key |
POST /public/leads | 20 requests per minute per IP |
| Trader endpoints | 900 requests per minute per IP |
GET /v1/traders/search | 120 provider searches per minute per organization; queries shorter than 2 characters do not call providers. |
POST /v1/traders/import | 30 selected-trader retrievals per minute per organization. |
Headers#
Authenticated API key responses include RateLimit-Remaining. When it reaches zero, the next request answers 429 with code rate_limited. A throttled response also includes Retry-After, in seconds until the current minute window ends.
http
HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
RateLimit-Remaining: 0
Retry-After: 30Backing off#
typescript
async function withRetry(req: () => Promise<Response>, attempts = 5) {
for (let i = 0; i < attempts; i++) {
const res = await req();
if (res.status !== 429 && res.status < 500) return res;
await new Promise((r) => setTimeout(r, 2 ** i * 500 + Math.random() * 250));
}
throw new Error("Rubi API unavailable after retries");
}