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

# Rate limits

# Rate Limits

The API applies rate limits per APIKey and per Endpoint.

Rate limits are defined by:

* Rate: total number of requests per hour
* Quota: total number of requests per 24 hours (per day)

### Normal Rate Limits

| API Name | Endpoint | Rate / hour | Quota / day |
| - | - | - | - |
| Authentication | [POST /auth/token](https://developers.api.com/docs/auth/token) | 60 | 500 |
| Authentication | [POST /auth/refresh](https://developers.api.com/docs/auth/refresh) | 120 | 1,000 |
| Place Order | [POST /orders](https://developers.api.com/docs/orders/place) | 3,600 | 50,000 |
| Modify Order | [PUT /orders/{id}](https://developers.api.com/docs/orders/modify) | 3,600 | 50,000 |
| Cancel Order | [DELETE /orders/{id}](https://developers.api.com/docs/orders/cancel) | 3,600 | 50,000 |
| Order Status | [GET /orders/{id}](https://developers.api.com/docs/orders/status) | 7,200 | 100,000 |
| Order List | [GET /orders](https://developers.api.com/docs/orders/list) | 1,800 | 20,000 |
| Account Information | [GET /accounts/{id}](https://developers.api.com/docs/account/info) | 1,800 | 20,000 |
| Account Balance | [GET /accounts/{id}/balance](https://developers.api.com/docs/account/balance) | 3,600 | 40,000 |
| Portfolio Information | [GET /portfolio/{id}](https://developers.api.com/docs/portfolio/info) | 1,800 | 20,000 |
| Portfolio Positions | [GET /portfolio/{id}/positions](https://developers.api.com/docs/portfolio/positions) | 1,800 | 20,000 |
| Latest Quote | [GET /marketdata/quote/{symbol}](https://developers.api.com/docs/marketdata/quote) | 18,000 | 200,000 |
| Order Book | [GET /marketdata/orderbook/{symbol}](https://developers.api.com/docs/marketdata/orderbook) | 10,000 | 100,000 |
| Price History | [GET /marketdata/history/{symbol}](https://developers.api.com/docs/marketdata/history) | 3,600 | 30,000 |
| Instruments List | [GET /instruments](https://developers.api.com/docs/reference/instruments) | 3,600 | 20,000 |
| Symbols List | [GET /symbols](https://developers.api.com/docs/reference/symbols) | 3,600 | 20,000 |
| WebSocket - Market Data | [WS /ws/marketdata](https://developers.api.com/docs/websocket/marketdata) | 60 connections | 500 connections |
| WebSocket - Orders | [WS /ws/orders](https://developers.api.com/docs/websocket/orders) | 60 connections | 500 connections |

### Notes

The API provides information about rate limit usage through response headers:

When the rate limit is exceeded, the system returns **HTTP 429 (Too Many Requests)**

```json lines theme={null}
429
Too Many Requests
{
    "error": "Rate Limit Exceeded",
    "message": "Too Many Requests"
}
```

### Recommendations

* Distribute API calls evenly across time intervals to avoid exceeding rate limits
* Cache infrequently changing data on the client side to reduce unnecessary requests
* Prioritize using APIs that support bulk data processing in a single call when available
* Use WebSocket connections for real-time data to reduce the number of HTTP requests
* Implement exponential backoff strategy when receiving a 429 response
* Consider aggregating requests during peak usage times
* Set up monitoring and alerting for rate limit violations


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.