Back to Directory
Dune

Dune

Blockchain & Crypto
Create and execute Dune queries, retrieve results, browse datasets, manage dashboards, and upload data for analysis.
Available through Sponge
MPP
WebsiteDocumentation

About Dune

Review the Service identity, supported languages, protocol versions, and source metadata discovered by the directory.

Service details

Service Id
2446b3f9-0a91-4072-99a5-d12f6f6ab5f5
Service origin
https://api.dune.com
ListedSeptember 24, 2026, 11:40 PM
Last checkedNovember 9, 2026, 7:20 AM

Protocol details

SourceOpenAPI

Endpoints

Endpoint details are saved from the OpenAPI document. Authentication requirements and prices are advertised information, not a verified payment or access guarantee. The document may contain additional endpoints.Open OpenAPI document
POST/v1/contracts/decode

Submit contracts for decoding

Submit up to 100 contracts (with their ABIs) for decoding in one request. Each item is validated and queued independently; the response reports a per-item result matched by index. Successful items are queued as "pending" and can be tracked with GET /v1/contracts/submissions or at dune.com/workspace. Submissions are attributed to the user who created the API key. "upgrade" submissions and protected namespaces are always routed to manual review.
GET/v1/contracts/submissions

List contract submissions

List the contract decoding submissions made by the authenticated account, newest first, with optional filters. Use this to track the status of submissions made via POST /v1/contracts/decode. Page with limit and the next_cursor returned by the previous response.
POST/v1/dashboards

Create a dashboard

Creates a new dashboard with optional visualization and text widgets.
GET/v1/dashboards/by-slug/{owner_handle}/{slug}

Get a dashboard by owner handle and slug

Retrieves the full state of a dashboard using the owner handle and URL slug.
GET/v1/dashboards/{dashboard_id}

Get a dashboard by ID

Retrieves the full state of a dashboard including widgets.
PATCH/v1/dashboards/{dashboard_id}

Update a dashboard

Updates dashboard metadata and/or replaces widgets.
POST/v1/dashboards/{dashboard_id}/archive

Archive a dashboard

Archives a dashboard by ID. The dashboard can be restored later.
GET/v1/datasets

List datasets

Retrieve a paginated list of datasets with optional filtering by owner and type
POST/v1/datasets/search

Search datasets

Search for datasets across the Dune catalog, with filtering by categories, blockchains, schemas, and more
POST/v1/datasets/search-by-contract

Search datasets by contract address

Find decoded datasets associated with a smart contract address
GET/v1/datasets/{slug}

Get a dataset by slug

Retrieve dataset information including columns, metadata, and ownership details
GET/v1/endpoints/{handle}/{endpoint_slug}/results

Custom Endpoints

Create custom API endpoints from Dune queries
POST/v1/execution/{execution_id}/cancel

Cancel a triggered execution request given the execution ID

Cancel a triggered execution request given the execution ID
GET/v1/execution/{execution_id}/results

Given an execution ID, returns result of a an execution request

Given an execution ID, returns result of a an execution request
GET/v1/execution/{execution_id}/results/csv

Get results of a query execution in CSV format

Given a query ID, returns the latest executed result of a query on Dune in CSV format
GET/v1/execution/{execution_id}/status

Check the status of an execution request

Check the status of an execution request
GET/v1/materialized-views

This lists all materialized view owned by the account tied to the API key

This lists all materialized view owned by the account tied to the API key
POST/v1/materialized-views

This upserts (create or replace) a materialized view from an existing query

This upserts a materialized view from an existing query. If the materialized view with the given name
DELETE/v1/materialized-views/{name}

This deletes a materialized view given a full name

This deletes a materialized view given a full name
GET/v1/materialized-views/{name}

This fetches a materialized view given a name

This fetches a materialized view given a name
POST/v1/materialized-views/{name}/refresh

This refreshes a materialized view

This refreshes a materialized view
POST/v1/pipelines/execute

Execute a pipeline

Executes a specified pipeline. A pipeline allows you to chain multiple queries and materialized view refreshes together and execute them as a single unit.
GET/v1/pipelines/executions/{pipeline_execution_id}/status

Get pipeline execution status

Retrieves the status of a pipeline execution, including the status of each node in the pipeline.
GET/v1/queries

List queries

Retrieve a paginated list of queries owned by the account tied to the API key
GET/v1/queries/{query_id}/visualizations

List visualizations for a query

Lists all visualizations attached to the specified query with pagination.
POST/v1/queries/{query_id}/visualizations

Create a visualization on an existing query

Creates a new visualization attached to the specified query.
POST/v1/query

Create and save a query on Dune

This API allows for anyone to create a query. The owner of the query will be under the context of the API key.
GET/v1/query/{queryId}

Returns the details of a query on Dune

This API allows for anyone to read the sql text, parameters, name, tags, and state of a query. For private queries, only the API key generated under the context of the owner of that query will work.
PATCH/v1/query/{queryId}

Update the details of a query on Dune

This API allows for anyone to update the sql text, parameters, name, tags, and state of a query. Only the API key generated under the context of the owner of that query will work.
POST/v1/query/{queryId}/archive

Archive Query on Dune

This API allows for anyone to archive a query. Only the API key generated under the context of the owner of that query will work. This does not delete the query, but will make it uneditable/unexecutable
POST/v1/query/{queryId}/private

Private Query on Dune

This API allows for anyone to private a query. Only the API key generated under the context of the owner of that query will work.
POST/v1/query/{queryId}/unarchive

Unarchive Query on Dune

This API allows for anyone to unarchive a query. Only the API key generated under the context of the owner of that query will work.
POST/v1/query/{queryId}/unprivate

Unprivate a query on Dune

This API allows for anyone to unprivate a query. Only the API key generated under the context of the owner of that query will work.
POST/v1/query/{query_id}/execute

Execute, or run a query for the specified query ID

Execute, or run a query for the specified query ID
GET/v1/query/{query_id}/pipeline

Get query pipeline

Builds a query pipeline from the specified query and returns the pipeline definition containing all the nested materialized views that the query depends on. A pipeline allows you to chain multiple queries together and execute them as a single unit.
POST/v1/query/{query_id}/pipeline/execute

Execute a query pipeline

Builds a query pipeline from the specified query and executes it. A pipeline allows you to chain multiple queries together and execute them as a single unit.
GET/v1/query/{query_id}/results

Get Latest Query Result

Given a query ID, returns the latest executed result of a query on Dune in JSON format
GET/v1/query/{query_id}/results/csv

Given a query ID, returns the latest executed result of a query on Dune as CSV

Given a query ID, returns the latest executed result of a query on Dune as CSV
POST/v1/sql/execute

Execute raw SQL query

Execute raw SQL query without requiring a stored query ID
GET/v1/uploads

List all tables owned by the account

Returns a paginated list of all tables owned by the authenticated account.
POST/v1/uploads

Create an empty uploaded table with a defined schema

Creates an empty uploaded table that can be inserted into with the /insert endpoint. Each successful table creation consumes 10 credits.
POST/v1/uploads/csv

Upload CSV file as a table

Upload a CSV file to create a table with automatic schema inference. The size limit per upload is 500MB. Storage limits: 100MB (free), 1GB (analyst), 15GB (plus).
DELETE/v1/uploads/{namespace}/{table_name}

Delete an uploaded table

Permanently deletes the specified uploaded table and all its data.
POST/v1/uploads/{namespace}/{table_name}/clear

Clear all data from an uploaded table

Removes all data from the specified uploaded table while preserving the table structure and schema.
POST/v1/uploads/{namespace}/{table_name}/insert

Insert data into an uploaded table

Inserts data into an existing table. Accepts CSV (text/csv) or NDJSON (application/x-ndjson) content types.
POST/v1/usage

Get Usage Data

Get usage data for the authenticated customer including private queries, dashboards, bytes used/allowed, and billing periods
DELETE/v1/visualizations/{visualization_id}

Delete a visualization

Deletes a visualization by its ID.
GET/v1/visualizations/{visualization_id}

Get a visualization by ID

Retrieves a visualization by its ID.
PUT/v1/visualizations/{visualization_id}

Update a visualization

Updates an existing visualization by its ID.

Agent payments

These payment protocols and options are advertised by the Service for agent purchases.

MPP

Advertises MPP payments for one or more endpoints. Check the endpoint documentation for authentication requirements.