Dune uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided. Codes in the 5xx range indicate an error with Dune’s servers.

HTTP Status CodeStatusDescription
200OKEverything worked as expected.
400Bad RequestThe request was unacceptable, often due to missing a required parameter.
401UnauthorizedNo valid API key provided.
402Payment RequiredThis request would exceed your configured limits per billing cycle.
403ForbiddenThe API key doesn’t have permissions to perform the request.
404Not FoundThe requested resource doesn’t exist.
409ConflictThe request conflicts with another request.
429Too Many RequestsToo many requests hit the API too quickly (rate limited).
500Server ErrorsGeneric internal server error.

For specific error code information, please refer to each of the endpoint itself. Here we list some common errors and suggest possible solution:

Invalid API key

  "error": "invalid API Key"

You did not input a valid API key. You can go generate a new key and make sure you save it in a safe place and paste the key over.

Permission error

"error": "not found: Query not found or private"

When you perform an action to a private query your API key doesn’t have access to, you will get this error. If you indeed own this query, please check the context of the API key and the query owner are the same.

Credit limit error

  "error": "This api request would exceed your configured limits per billing cycle. Please visit your settings on dune.com and adjust your limits to continue usage."

You are trying to make a request but don’t have enough credits (configured) on your account. If you’d like to incur overage, head over to settings -> subscription and adjust the limit you have set within “limit extra credits” toggle.