# Rate limits

### Credit Quotas

The API config key system allows Pacifica to provision higher rate limits to verified users, ensuring real traders have adequate resources while protecting against abuse.

| Tier                 | Base Credits/60s |
| -------------------- | ---------------- |
| Unidentified IP      | 125              |
| Valid API Config Key | 300              |

These are base quotas and may be increased based on account reputation. The credit is shared across a main account and all its subaccounts. Naturally, higher [fee tier](/docs/trading-on-pacifica/trading-fees.md) grants an account higher rate limits.

| Tier | Credits/60s |
| ---- | ----------- |
| 1    | 300         |
| 2    | 600         |
| 3    | 1200        |
| 4    | 2400        |
| 5    | 6000        |
| VIP1 | 20000       |
| VIP2 | 30000       |
| VIP3 | 40000       |

### Credit Costs

| Action                  | Unidentified IP | API Config Key |
| ----------------------- | --------------- | -------------- |
| Standard request/action | 1               | 1              |
| Order cancellation      | 0.5             | 0.5            |
| Heavy GET requests      | 3–12            | 1–3            |

When credits are exhausted, requests return HTTP 429.

### WebSocket Limits

* Max 300 concurrent connections per IP
* Max 20 subscriptions per channel per connection

### Checking Your Quota

> **Note:** All credit values are multiplied by 10 to support fractional costs (e.g., `r=1200` = 120.0 credits).

**REST API** — Response headers:

```
ratelimit: "credits";r=1200;t=32
ratelimit-policy: "credits";q=1250;w=60
```

**WebSocket** — `rl` field in action responses:

```json
{"rl": {"r": 1200, "q": 1250, "t": 32}}
```

| Field | Description            |
| ----- | ---------------------- |
| `r`   | Remaining credits      |
| `t`   | Seconds until refresh  |
| `q`   | Total quota per window |
| `w`   | Window size in seconds |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://pacifica.gitbook.io/docs/api-documentation/api/rate-limits.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
