Please review the Authentication page for further information on how to authenticate your requests.
Please review the Endpoints page for further details about each endpoint, what it provides and how to submit queries.
The rate limits we have imposed have been specifically tailored towards allowing a frequent (perhaps nightly) fetch of daily results.
These limits should be adequate for the volume of data that the majority of our clients receive.
That doesn't stop you getting historic data, just not all at once! You'll need to phase your requests for historic data.
The following limitations are currently in place for the following endpoints:
Maximum calls = 60 per minute.
Rate limits are applied across requests where the following match previous requests:
Note: Failed requests are included in rate limiting.
A successful request will contain current rate-limiting information that may be useful in determining when you can make another request.
This information is contained in the response headers:
| Name | Value |
|---|---|
X-Rate-Limit-Limit |
Integer (number of seconds) |
X-Rate-Limit-Remaining |
Integer (0 indicates further requests will fail until limit is reset) |
X-Rate-Limit-Reset |
ISO Date/Time when you can successfully submit another request |
Exceeding the maximum will return a 429 - Too Many Requests response, accompanied by the following information:
Response body will contain guidance notes: API calls quota exceeded! maximum admitted 60 per 1m.
Headers:
| Name | Value |
|---|---|
Retry-After |
Integer (number of seconds) |
Date |
Current Server ISO Date/Time |