Rate Limiting

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:

EnvironmentRate Limit
Market Data3–9 requests/min, according to your plan
Paper Trading15 requests/min
Live Trading15 requests/min
Live Streaming5 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 HeaderDescription
RateLimit-LimitNumber of permitted API requests per time interval (currently: per minute).
RateLimit-RemainingNumber of permitted API requests left in this time interval.
RateLimit-ResetNumber 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 HeaderDescription
Retry-AfterNumber of seconds until the user can issue successful requests again. (This will essentially be the same value as the header RateLimit-Reset.)