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

# Rate limits

> Request quotas, catalog cooldown, and withdraw caps.

# Rate limits

Production tenants have enforceable limits (values can be adjusted by IMBA per partner). Defaults:

| Limit                           | Default | Effect                                        |
| ------------------------------- | ------- | --------------------------------------------- |
| API calls / rolling minute      | 300     | `429` / `rate limit exceeded`                 |
| Catalog calls / rolling minute  | 60      | Extra quota for `gift-offers` / `esim-offers` |
| Catalog min interval            | 1000 ms | `429` / `catalog cooldown` if burst           |
| Max open money documents (24h)  | 40      | `429` / `too many open documents`             |
| Max withdraw USDT / rolling 24h | 50000   | `422` / `withdraw_limit_exceeded`             |

`limit` on catalog list requests is a **page size** (≤ 50), not an RPS setting.

## Recommended client behaviour

1. Back off on `429` (exponential + jitter)
2. Deduplicate creates with stable `ext_id` (avoid inflight storms)
3. Cache catalog responses; respect cooldown
4. Poll documents with moderate cadence; prefer webhooks for terminals

IP allowlisting for your egress may be agreed at onboarding; otherwise it is not required to ship.