> ## Documentation Index
> Fetch the complete documentation index at: /llms.txt
> Use this file to discover all available pages before exploring further.

# Rate limits

> 200 requests per minute from one IP address, and how to back off.

The API allows **200 requests per 60 seconds from one IP address**. The limit counts every request from that address, across all endpoints and keys.

## Headers

Every response tells you where you stand:

| Header | Meaning |
| - | - |
| `X-RateLimit-Limit` | Requests allowed in the window. `200`. |
| `X-RateLimit-Remaining` | Requests you have left in this window. |
| `X-RateLimit-Reset` | Seconds until the window resets. |

## When you go over

The API returns `429` with a `Retry-After` header, in seconds:

```json
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please slow down.",
    "requestId": "req_8a1c4e2f9b7d3a60"
  }
}
```

Wait for `Retry-After` seconds, then send the request again. For a money call, send it with the **same** `Idempotency-Key`.

```javascript Node
async function withBackoff(send, attempts = 5) {
  for (let i = 0; i < attempts; i++) {
    const res = await send();
    if (res.status !== 429) return res;
    const wait = Number(res.headers.get('retry-after') ?? 2 ** i);
    await new Promise((r) => setTimeout(r, wait * 1000));
  }
  throw new Error('Still rate limited after retries');
}
```

```python Python
import time

def with_backoff(send, attempts=5):
    for i in range(attempts):
        res = send()
        if res.status_code != 429:
            return res
        time.sleep(float(res.headers.get("Retry-After", 2 ** i)))
    raise RuntimeError("Still rate limited after retries")
```

## Stay under the limit

* **Use webhooks, not polling,** to learn when a transaction finishes.
* **Use bulk payouts** to send up to 100 payouts in one request. See [Bulk payouts](/guides/bulk-payouts.md).
* **Cache reference data.** Bank and operator lists change rarely.
* **Spread batch jobs out.** A job that sends 500 requests in a burst will be limited. Pace it.

> [!NOTE]
>
> The limit is per IP address, not per key. Several services behind one outbound address share one
> allowance.

## Hosted checkout limits

The public checkout behind a [payment link](/guides/payment-links.md) has its own limits: 120 payment attempts per link and 20 per payer IP address in any 10 minutes. Over that, the checkout returns `429`.
