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.
HTTP Status Code | Status | Description |
---|---|---|
200 | OK | Everything worked as expected. |
400 | Bad Request | The request was unacceptable, often due to missing a required parameter. |
401 | Unauthorized | No valid API key provided. |
402 | Payment Required | This request would exceed your configured limits per billing cycle. |
403 | Forbidden | The API key doesn’t have permissions to perform the request. |
404 | Not Found | The requested resource doesn’t exist. |
409 | Conflict | The request conflicts with another request. |
429 | Too Many Requests | Too many requests hit the API too quickly (rate limited). |
500 | Server Errors | Generic 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
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
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
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.
Was this page helpful?