dune

Query blockchain data and manage Dune queries, visualizations, and dashboards via the Dune CLI.

1|1|Updated May 11, 2026
One-click install
npx skills add https://github.com/taxmaxi/taxmaxi --skill dune-taxmaxi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dune
Source: https://github.com/taxmaxi/taxmaxi/tree/main/.agents/skills/dune
Command: npx skills add https://github.com/taxmaxi/taxmaxi --skill dune-taxmaxi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Accessing on-chain analytics normally requires navigating the Dune web UI, writing SQL by hand, and manually assembling dashboards. This Skill lets you run DuneSQL queries, discover decoded contract tables, and build visualizations and dashboards directly from the terminal through the Dune CLI. ## Core Features & Use Cases - DuneSQL Query Execution: Run ad-hoc SQL with dune query run-sql or execute saved queries with parameters, performance tiers, and polling for long-running jobs. - Dataset Discovery: Search the Dune catalog by keyword, category, or contract address with full column schemas before writing SQL. - Visualizations & Dashboards: Create charts, counters, and tables on saved queries, then assemble them into dashboards with text and visualization widgets. - Use Case: Ask for the daily DEX trading volume on Ethereum over the last 7 days; the Skill discovers the dex.trades Spellbook table, writes a partition-filtered DuneSQL query, executes it, and returns the results as JSON. ## Quick Start Ask the assistant to run a Dune query showing the latest 10 Ethereum blocks, and it will execute the appropriate dune CLI command and return the results.

Frequently Asked Questions about dune

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a DuneSQL query from the command line?▼

Use `dune query run-sql --sql "<your SQL>" -o json` to execute raw DuneSQL directly without creating a saved query. For reusable queries, create one with `dune query create` and execute it with `dune query run <id>`.

How do I find decoded tables for a smart contract on Dune?▼

Run `dune dataset search-by-contract --contract-address <address> --include-schema -o json` to list all decoded event and call tables for that contract. The schema output gives you exact column names for writing SQL.

What authentication does the Dune CLI require?▼

All commands except `dune docs search` require a Dune API key. The key is resolved from the `--api-key` flag, the `DUNE_API_KEY` environment variable, or a saved config file created with `dune auth`.

Why does my Dune query fail with a type mismatch on addresses?▼

Addresses in Dune are stored as varbinary, not strings, so comparing them to quoted strings fails. Use the 0x-prefixed literal syntax without quotes, such as `WHERE "from" = 0xd8da6bf26964af9d7eed9e03e53415d37aa96045`.

Why is my Dune query slow or hitting resource limits?▼

Queries without a partition filter scan the entire table history. Add a `WHERE` clause on the partition column such as `block_time` or `evt_block_time`, and use `--performance large` for heavy joins or aggregations.

Can the Dune CLI list all indexed blockchains or table sizes?▼

No. Blockchain listing and table size analysis are not available via the CLI. Those capabilities are only accessible through the Dune MCP server or the web UI.