Rate limits

Rate limits are applied per client IP address using a token bucket algorithm. In the Billingrails sandbox environment, the default rate limit is 50 requests per minute.

Rate limit response

When you exceed the rate limit, the API returns 429 Too Many Requests:

{
  "error": {
    "type": "request_error",
    "code": "too_many_requests",
    "message": "Too many requests. Please try again later."
  }
}

Best practices

• Batch where possible. Fewer large requests beat many small ones.
• Cache responses that don't change frequently (e.g., party details, wallet balance).
• Implement exponential backoff on 429 responses.

Related

• Error handling — Error response format
• Idempotency — Safe retries after rate limiting