Troubleshooting Errors

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.

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.