# API usage, limits and common errors

> Track your requests and active accounts, understand rate limits and quotas, and read the error codes you'll meet most.

Canonical page: https://propmetaapi.com/help/api-usage-and-limits  
Topic: API access & keys  
Last updated: 2026-10-28

## 1. API overview

**API → API overview** shows your plan and end date, your rate limits (requests per minute and trade calls per minute) and two meters: **Active accounts** and **Registered accounts**.

## 2. API usage

**API usage** shows requests, trade requests and peak active accounts per UTC day for the last 7, 30 or 90 days, and the busiest routes, errors and open WebSockets for the last hour, day or week. Use it to spot an app that polls too often or a spike in errors.

## 3. Errors you'll see most

- `401 UNAUTHORIZED` — the key is missing, mistyped, revoked or expired.
- `403 FORBIDDEN` — the key lacks the permission (for example a Read key placing a trade) or the account isn't in its scope.
- `403 QUOTA_EXCEEDED` — you reached a limit, such as active or registered accounts. Deactivate or remove accounts, or move to a bigger plan.
- `429 RATE_LIMITED` — too many requests this minute. Wait the number of seconds in `Retry-After`, then switch from polling to webhooks or WebSocket.
- `402 SUBSCRIPTION_EXPIRED` — your plan ended; see [When your plan ends](https://propmetaapi.com/help/plan-expiry).

Every error has a stable `code`. Build your logic on the code, not the message, and retry only errors marked `retryable`.

## For developers

- [Limits & quotas](https://propmetaapi.com/docs/limits)
- [Errors](https://propmetaapi.com/docs/errors)

## Related guides

- [Your API token and scoped keys](https://propmetaapi.com/help/api-keys): Reveal and rotate your primary token, create keys with limited permissions or accounts, and keep them safe.
- [When your plan ends](https://propmetaapi.com/help/plan-expiry): What stops, what keeps working, what happens to your accounts after the grace period, and how to get everything back.
- [Account connection problems](https://propmetaapi.com/help/account-connection-problems): Login rejected, disconnected, disabled by the broker, not connected or trading refused — what each state means and how to fix it.
