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

# Rate limits

> Two limits per minute, and the one field to send when you call on behalf of your users.

No API key. Quote, build and submit are each limited to 10 requests a minute, counted separately per IP address and per requester wallet (`sender`). Reading markets and transfer status is not limited.

| Scope                | Limit       | Applies to                                                                                |
| -------------------- | ----------- | ----------------------------------------------------------------------------------------- |
| Per IP address       | 10 a minute | `POST /bridge/quote`, `POST /bridge/build`, `POST /bridge/transfers/{id}/submit`          |
| Per requester wallet | 10 a minute | the same three                                                                            |
| Reads                | none        | `GET /bridge/source-chains`, `/bridge/routes`, `/bridge/venues`, `/bridge/transfers/{id}` |

A completed transfer costs three calls. A `429` carries the longer of the two waits as `retryAfterMs` and a `Retry-After` header.

```json theme={null}
{ "error": { "code": "rate_limited", "message": "…", "retryAfterMs": 1200 } }
```

Quote once per user action, not per keystroke, and reuse `decisionId` for the build: a quote stays valid until its `expiresAt`. If your server calls on behalf of many users from one IP, spread quotes across those users' actions rather than polling.

## `userIp`

If your server calls the API on behalf of your users, send each user's own IP as `userIp` on the quote. Two venues are geo-gated and refuse an order without it; `GET /bridge/venues` marks them `capabilities.requiresUserIp`. Without the field those venues simply drop out of the table with a reason in `rejected`. It is remembered on the quote and reused on build, so send it once. If your users call from their own browsers, nothing is needed.