Request Limit

Request Limit Policy

Request limit refers to the limit on the number of API calls per unit of time. DFINERY applies the request limit policy to all Open APIs it provides to ensure stable service operation.

Classification	Rate Limit (Default)
Event	1,000,000 per minute
Identity	10,000 per minute
Profile	10,000 per minute
Export	100 cases per hour, 5 cases at the same time

If the request limit is exceeded, all subsequent API requests will fail. After the time limit has elapsed and the request limit is reset, you can receive a normal response. It is recommended to consider the request limit when linking APIs.

If you need to make more calls than the default request limits, please contact our Customer Success team.

Check request limit status

Request limit status can be checked through the value of the response header.

Header Name	Explanation
X-Rate-Limit-Limit	Initialization cycle
X-Rate-Limit-Remaining	Number of requests remaining
X-Rate-Limit-Reset	Time for the transmission speed to be initialized

X-Rate-Limit-Limit consists 1Y: 1 year, 1M: 1 month, 1D: 1 day, 1H: 1 hour, 1M: 1 minute, 1S: 1 second of .

X-Rate-Limit-Rest is in Timestamp format.1719397769

Example of a request limit status response

Normal response

curl -i https://openapi.dfinery.ai/api/v1/...
> HTTP/2 200
> x-ratelimit-limit: 1d
> x-ratelimit-remaining: 99999
> x-ratelimit-reset: 1682593200268

If the API call limit is exceeded (response code 429)

curl -i https://openapi.dfinery.ai/api/v1/...
> HTTP/2 429
> x-ratelimit-limit: 1d
> x-ratelimit-remaining: 0
> x-ratelimit-reset: 1682640000000