Show for

Rate Limiting

Fair usage limits to ensure platform stability for all merchants.

Rate Limits by Plan

100

Requests/second (Test)

1,000

Requests/second (Live)

10,000

Requests/second (Enterprise)

Response Headers

X-RateLimit-LimitYour plan's requests-per-second limit.

X-RateLimit-RemainingRemaining requests in the current window.

X-RateLimit-ResetUnix timestamp when the limit resets.

Retry-AfterSeconds to wait before retrying (only on 429 responses).

Handling Rate Limits

async function makeRequest(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (err) {
      if (err.status === 429) {
        const retryAfter = err.headers['retry-after'] || 1;
        await sleep(retryAfter * 1000);
      } else {
        throw err;
      }
    }
  }
  throw new Error('Max retries exceeded');
}

Tips

Use bulk endpoints when available to reduce request count.
Cache responses for data that doesn't change frequently.
Implement exponential backoff for retries.
Contact support if you need higher limits for your use case.