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

# Rate limits

> Complexity-based limits, quotas, and best practices for staying within them.

Fluz applies fair-use rate limits on the transactional graph and the OAuth service. Limits are tuned to typical integration patterns; contact your account team if your production workload needs headroom.

## When you're throttled

Rate-limited requests return an HTTP `429` on the transport, or a rate-limit error code inside the GraphQL `errors` array. Back off before retrying and add jitter to smooth bursts.

## Best practices

1. **Ask for less.** Trim your selection set to the fields you actually use.
2. **Batch reads.** One query that returns 100 items costs less than 100 queries returning one each.
3. **Use webhooks instead of polling.** See [Configure App Widget](/developers/configure-app-widget) for webhook setup.
4. **Retry with exponential backoff and jitter** — never in a tight loop.
5. **Refresh access tokens ahead of expiry** to avoid 401 → mint-token → retry cycles under load.