⏱️ Rate Limits

Learn Forkast's API rate limits, including global and endpoint-specific caps, HTTP 429 errors, and best practices for handling requests.

To ensure platform stability and fair usage, the Forkast enforces the following rate limits.

🌍 Global Rate Limits

All API functions are subject to a global rate limit of:

  • 1,000 requests per minute per IP

If this limit is exceeded, additional requests may be throttled or rejected until the rate window resets.

🎛️ Function-Specific Rate Limits

The following endpoints have additional per-second limits:

  • Place Single Order – 30 requests per second
  • Cancel Single Order – 30 requests per second
  • Place Bulk Order – 8 requests per second
  • Cancel by Market ID – 5 requests per second

These limits apply independently of the global per-minute limit.

⚠️ Rate Limit Errors

If a rate limit is exceeded, the API will return an HTTP 429 (Too Many Requests) response.

We recommend implementing the following best practices:

  • Respect Retry-After headers when provided
  • Implement exponential backoff for retries
  • Avoid aggressive retry loops
  • Monitor response codes to proactively manage request pacing

Proper rate limit handling will ensure uninterrupted access and optimal trading performance.