Rate Limits
Each endpoint is rate-limited on a per-minute basis. That means that once your application has hit the limit, you'll receive an HTTP 429 error response until the limit resets the following minute.
Rate limits are global and are enforced on a per API-key basis. If you would like an increase in your application, please reach out to [email protected].
Rate Limits in Response Headers
There are helpful fields in the response header that can provide visibility to your application's API usage on a per-response basis. They are described below:
| Header | Type | Description |
|---|---|---|
x-rate-limit-remaining | integer | The number of calls remaining for the endpoint and time limit belonging to this request |
x-ratelimit-limit | string | the overall limit for the endpoint and time limit belonging to this request. e.g. 1m denotes 1 minute |
x-rate-limit-reset | string | the timestamp when the limits will reset for your IP |
#using the -i option to only return the header
#note the x-rate-limit-remaining and x-rate-limit-limit below
curl -i 'https://api.finrock.io/dac/v1/supported-assets'
HTTP/2 200
date: Sat, 27 Aug 2022 18:22:48 GMT
content-type: application/json; charset=utf-8
content-length: 3026
x-frame-options: SAMEORIGIN
x-content-type-options: nosniff
x-xss-protection: 1; mode=block
strict-transport-security: max-age=31536000; includeSubDomains; preload
permissions-policy: geolocation=(self), microphone=()
referrer-policy: no-referrer
x-node-id: f1d758ba
x-rate-limit-limit: 1m
x-rate-limit-remaining: 999
x-rate-limit-reset: 2022-08-27T18:23:48.8071879Z