A command-line interface for interacting with the Dune API.
curl -sSfL https://github.com/duneanalytics/cli/raw/main/install.sh | bash# Save your API key to ~/.config/dune/config.yaml
dune auth --api-key <key>
# Or run interactively (prompts for key)
dune auth
# Or set via environment variable
export DUNE_API_KEY=<key>The --api-key flag is available on all commands to override the stored key.
Manage and execute Dune queries.
| Command | Description |
|---|---|
query create --name <name> --sql <sql> [--description] [--private] [--temp] |
Create a new saved query |
query get <query-id> |
Get a saved query's details and SQL |
query update <query-id> [--name] [--sql] [--description] [--private] [--tags] |
Update an existing query |
query archive <query-id> |
Archive a saved query |
query run <query-id> [--param key=value] [--performance medium|large] [--limit] [--timeout] [--no-wait] |
Execute a saved query and display results |
query run-sql --sql <sql> [--param key=value] [--performance medium|large] [--limit] [--timeout] [--no-wait] |
Execute raw SQL directly |
Manage query executions.
| Command | Description |
|---|---|
execution results <execution-id> [--limit] [--offset] [--timeout] [--no-wait] |
Fetch results of a query execution |
Search the Dune dataset catalog.
| Command | Description |
|---|---|
dataset search [--query] [--categories] [--blockchains] [--schemas] [--dataset-types] [--owner-scope] [--include-private] [--include-schema] [--include-metadata] [--limit] [--offset] |
Search for datasets |
dataset search-by-contract --contract-address <address> [--blockchains] [--include-schema] [--limit] [--offset] |
Search for decoded tables by contract address |
Categories: canonical, decoded, spell, community
Search and browse Dune documentation. No authentication required.
| Command | Description |
|---|---|
docs search --query <text> [--api-reference-only] [--code-only] |
Search the Dune documentation |
Show credit and resource usage for your account.
dune usage [--start-date YYYY-MM-DD] [--end-date YYYY-MM-DD]All commands (except auth) support -o, --output <format> with text (default) or json.
