Skip to main content

​
Overview

To protect reliability and ensure fair usage, requests to the API are subject to rate limits. Rate limits are enforced per API key and apply across all endpoints.

​
Limits

The API uses a token-bucket–style rate limiter that allows short bursts while enforcing a sustained request rate. Current limits (subject to change):
  • Burst capacity: approximately 50 requests
  • Sustained rate: approximately 10 requests per second per API key

​
Rate limit exceeded (429)

When a request exceeds the rate limit, the API responds with 429 Too Many Requests.

​
Example response

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 1

{
  "title": "Too many requests",
  "status": 429,
  "detail": "Rate limit exceeded",
  "instance": "/v1/address"
}