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

# Rate Limits

> Request rate limits per plan

## Rate Limits

Each API key has a per-minute request limit based on your plan tier. Limits are enforced via a sliding window.

| Plan                  | Requests per Minute |
| --------------------- | ------------------- |
| Starter               | 1                   |
| Pro                   | 30                  |
| Max                   | 60                  |
| Expired (7-day grace) | 1                   |

## Rate Limit Headers

When you're rate limited, the API returns `429 Too Many Requests`:

```json theme={null}
{ "detail": "Rate limit exceeded. Try again shortly." }
```

## Best Practices

* **Cache responses** — if you're polling `/v1/news` frequently, cache results for a few seconds
* **Use WebSocket** for real-time data instead of polling the REST API (Pro and Max plans)
* **Spread requests** — avoid bursting all requests in the first second of each minute

## IP-Based Protection

TradingNews also monitors for abuse patterns. If a single IP address uses 3 or more different API keys within 1 minute, that IP is temporarily blocked for 10 minutes. This prevents credential stuffing attacks.