Skip to main content
The Dune API uses standard HTTP headers to tell clients about their rate limits and about endpoints that are being retired. Browser clients can read all of these headers.

Rate limit headers

Responses to authenticated requests include the rate limits that applied to the request. The headers follow the IETF RateLimit header fields draft. A request can be subject to more than one policy. Each policy appears as a separate entry in the list, and the most restrictive one applies. For example, a read request on the Plus plan that hit its limit returns:
A positive r does not guarantee that the next request will be accepted. If the headers are missing, for example on a 401 Unauthorized response, back off exponentially before retrying.

Deprecation headers

Endpoints that are being retired send these headers on every response. See the versioning and deprecation policy. Log or alert on these headers in your client so you notice a deprecation before the endpoint is removed.