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 endpoints themselves. Here we list some common errors and suggest possible solutions:

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 on a private query your API key doesn’t have access to, you will get this error. If you indeed own this query, please check that 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 extra credits, head over to settings -> subscription and adjust the limit you have set within “limit extra credits” toggle.

Authentication Analyze Onchain Data

Introduction

Quick Start

Executions and Results

Query Management

Data Uploads

Datasets

Materialized Views

Pipelines

Account Management

Post-processing

Webhooks

Client SDKs

Resources

Troubleshooting Errors

Invalid API key

Permission error

Credit limit error

​Invalid API key

​Permission error

​Credit limit error

Invalid API key

Permission error

Credit limit error