Dune Docs

Get Started

Web App

Query Engine

Data Catalog

API Reference

Datashare

Start building

Support

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.

Update Query

The column name to use from the query results.

The ID of the query to fetch results from.

List of valid options for 'enum' type parameters.

Indicates if freeform input is allowed for this parameter.

Indicates if multiple selections are allowed for this parameter.

The type of the parameter, determines the format of 'value(s)'. 'number': Numeric parameters, the value must be a number (e.g., '20'). 'text': String parameters, value can be any text including hex 0x-prefixed values (e.g., '0xae2fc...'), an empty value defaults to an empty string. 'datetime': Date and time parameters, value must be in 'YYYY-MM-DD hh:mm:ss' format (e.g., '2021-12-31 23:59:59'). 'enum': Parameters with a specific list of values, 'EnumValues' field is mandatory, providing a JSON list of strings representing valid options, the 'value' must be one of these options (e.g., 'Option1').

The default value used by this parameter during execution, format depends on the type.

An array of string values, used when multiple selections are allowed.

An issue with the validation of the request

Maximum number of private queries reached on current pricing plan. Please upgrade for more

Not allowed to alter this query, make sure you're using an API key generated under the context of the owner of this query

Generic error message, given when an unexpected condition is encountered and no more specific message is available. Please consult the API documentation for more details.

Update the details of a query on Dune

Dune is a web-based platform that allows you to query public blockchain data and aggregate it into beautiful dashboards.

Welcome

Quickstart

Navigate the Ever-Expanding World of Web3 Data with Ease, from Beginners to Experts

Web3 Data Resources

How to write a query to find out the monthly $ gas spent for your wallet

Create your first query

How to craft AI-assisted queries with ease

Create AI-Assisted Queries

Dune AI Prompt Engineering

Create New Content

How to create a combination bar chart and line chart to visualize the monthly $ gas spent for your wallet

Create your first visualization

Navigate the Query Editor

Find Datasets on Dune

How to build a Farcaster Frame using Frog and Dune API

Build a Frame with Dune API

Streamline tracking of your crypto transactions, including profit and loss calculations and determining cost basis, using Dune.

2023 Crypto Profits and Losses with Dune API

Export Data Out of Dune

Create and Manage Teams

What is the credit system on Dune and how credits work on Dune

Credit System on Dune

How to efficiently search for content on Dune

Search for Content on Dune

Share Dune Content

How to share your query result and charts with others

Share your query

How to transfer ownership of your creations

Transfer Ownership

Dune has built the perfect tools to efficiently extract information from blockchain data.

Overview

The query editor allows you to query blockchain data using DuneSQL.

Writing Queries

The Data Explorer allows you to search for blockchain and other data to use in your Queries. Here's how it works.

Finding Tables

Parameters allow you to implement variables in certain parts of your Query. This is useful if you want to create a Query that you can reuse with different parameters.

Using Parameters

Learn how to leverage the power of query scheduling for a more reliable and up-to-date dashboard display!

Scheduling Queries

Queries have a version history, where you can compare and revert to previous query versions.

Version History

Charts are good for condensing data points into a Visualization. Learn how to make them here

Create Graphs

Counters give you a way to display a single number in a prominent way.

Create counters

Tables are a way to display your data in a tabular format.

Formatting Tables

Dashboards are where Dune's content lives and gets discovered.

Create Dashboards

Instead of working with the logs and traces in their raw states, on Dune we decode smart contract activity into nice human-readable tables.

Decoding Contracts

Dune Teams are shared workspaces for Wizards to collaborate within.

Teams on Dune

Wand is a beta suite of tools for writing SQL queries with the help of large language models.

Dune AI

Upload Data

Embeds allow you to enjoy beautiful, updating Dune charts across the web!

Share your work

Get the most out of Dune's powerful content search functionality

Search content

Alerts allow you to receive notifications based on any query

Alerts

DuneSQL, a Trino fork, is fine-tuned for blockchain analytics.

When and how do queries on Dune get executed?

Executions

The "Query View" feature in DuneSQL allows you to use an existing query as a view in another query. This powerful functionality enables you to create reusable queries, build complex queries, and take advantage of existing queries as views.

Query Views

Materialized tables are a way to store the results of a query in a table that can be queried like any other table. This is useful when you have a query that takes a long time to run, or when you want to use the results of a query in another query.

Materialized Views

Get the most out of DuneSQL by writing efficient queries.

Writing Efficient Queries

The following table lists all of the keywords that are reserved in DuneSQL, along with their status in the SQL standard. These reserved keywords must be quoted (using double quotes) in order to be used as an identifier.

Reserved keywords

DuneSQL supports a wide range of built-in functions and operators.

Aggregate functions

Array functions and operators

Base58 functions

Binary

Bitwise

Comparisons

Conditional expressions

Conversions

Date and time functions and operators

Decimal functions and operators

HyperLogLog functions

Lambda expressions are anonymous functions which are passed as arguments to higher-order SQL functions.

Lambda expressions

List of functions by topic

List of functions and operators

Logical operators

Map functions and operators

Mathematical functions and operators

Machine learning functions

Quantile digest functions

Regular expression functions

Set Digest functions

SS58 functions

Tron address functions

String functions and operators

System information

T-Digest functions

Teradata functions

URL functions

UUID functions

Varbinary functions (DuneSQL)

Window functions

Dune's extensive data catalog provides detailed analytics for a wide range of blockchains.

Bring your own data

EVM Overview

Description of the ethereum.transactions table on Dune

Transactions

ethereum.transactions

Description of the ethereum.logs table on Dune

Logs

ethereum.logs

Description of the ethereum.traces table on Dune

Traces

ethereum.traces

Description of the ethereum.creation_traces table on Dune

Creation Traces

ethereum.creation_traces

Description of the ethereum.blocks table on Dune

Blocks

ethereum.blocks

Description of the ethereum.withdrawals table on Dune

Withdrawals

ethereum.withdrawals

Simplifying smart contract analysis through human-readable tables.

On Dune, we parse all message calls and transactions made to smart contracts in their own tables.

Call Tables

Smart Contracts emit event logs when certain predefined actions are completed.

Event Logs

Description of the ethereum.contracts table on Dune

Decoded Contracts

ethereum.contracts

Description of the ethereum.logs_decoded table on Dune

logs_decoded

ethereum.logs_decoded

Description of the ethereum.traces_decoded table on Dune

traces_decoded 

ethereum.traces_decoded

Exploring the landscape of digital assets on the blockchain.

Tokens

Comprehensive daily records of token balances for Ethereum Virtual Machine (EVM) addresses, covering native currencies and various token standards.

Daily Balances

Daily Token Balances on EVM Networks

Description of the dex.trades table on Dune

DEX Trades

dex.trades

Description of the dex_aggregator.trades table on Dune

DEX Aggregator Trades

dex_aggregator.trades

Description of the nft.trades table on Dune

NFT Trades

nft.trades

Aptos is a next-generation blockchain designed for scalability, security, and reliability.

API Documentation

API Quickstart

Tables (upload data)

Webhooks

Executions and Results

Queries

Update Query

Headers

Path Parameters

Body

Response