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

# Rate Limits

> How to handle partner API throttling safely in production.

Partner endpoints enforce rate limits to protect service reliability.

## Throttle Signal

When throttled, the API returns `429 Too Many Requests` with:

* `Retry-After`
* `X-RateLimit-Limit`
* `X-RateLimit-Remaining`
* `X-RateLimit-Reset`

## Retry Strategy

1. Respect `Retry-After` exactly.
2. Apply exponential backoff with jitter.
3. Reuse the same `Idempotency-Key` for retried writes.
4. Do not send parallel retries for the same business action.

## Client Architecture Recommendations

* Use a client-side write queue or concurrency cap so retries stay controlled.
* Use token-bucket or leaky-bucket throttling in your client.
* Separate read and write retry policies.
* Trigger alerts when sustained `429` exceeds your SLO threshold.