Rate Limiting
This page is concerned with providing you with specific information on rate limiting.
We introduce rate limits to ensure fair access to the platform for everyone. You can be sure that everybody has to follow the same set of rules. We will throttle the access of anyone trying to exceed certain limits.
This way, you can be sure the lemon.markets API will be available for you whenever you like. You will not be restricted by the way other people use the API.
Rate Limits
These are the rate limits as they are applied across our different environments:
| Environment | Rate Limit |
|---|---|
| Market Data | 3–9 requests/min, according to your plan |
| Paper Trading | 15 requests/min |
| Live Trading | 15 requests/min |
| Live Streaming | 5 requests/min |
NOTE: Early customers are temporarily exempt from those limits and may see higher rate limits for the time being.
HTTP Response Headers
These are the HTTP response headers that you will see for every API request:
| HTTP Response Header | Description |
|---|---|
RateLimit-Limit | Number of permitted API requests per time interval (currently: per minute). |
RateLimit-Remaining | Number of permitted API requests left in this time interval. |
RateLimit-Reset | Number of seconds until the current time interval ends. |
Hitting the Rate Limit
If a user performs too many requests per time interval, they will receive the HTTP status code 429 Too Many Requests. In addition to the other response headers, the following will be sent as well.
| HTTP Response Header | Description |
|---|---|
Retry-After | Number of seconds until the user can issue successful requests again. (This will essentially be the same value as the header RateLimit-Reset.) |