Rate Limiting

The Web3 Portal API implements rate limiting to ensure fair usage and maintain system stability.

Default Limits

Resource	Limit	Window
API Requests	300 requests	Per minute (per API key)
Failed Authentication Attempts	5 attempts	Per minute (per IP)

Rate Limit Headers

Every API response includes rate limit information in the headers:

HTTP/1.1 200 OK
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 295
X-RateLimit-Reset: 1673456789

Header Definitions

Header	Description
X-RateLimit-Limit	Maximum requests allowed in the current window
X-RateLimit-Remaining	Requests remaining in the current window
X-RateLimit-Reset	Unix timestamp when the rate limit resets

Rate Limit Exceeded

When you exceed the rate limit, you'll receive a 429 Too Many Requests response:

{
  "success": false,
  "message": "Too many requests. Please slow down.",
  "errors": null
}

The Retry-After header indicates seconds until you can retry:

HTTP/1.1 429 Too Many Requests
Retry-After: 45
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1673456789