Prerequisites

Assume the Dune CLI is already installed and authenticated. Do not run upfront install or auth checks. Just execute the requested dune command directly.

If a dune command fails, inspect the error to determine the cause and follow the recovery steps in install-and-recovery.md:

• "command not found" → CLI not installed. See CLI Not Found Recovery.
• 401 / "unauthorized" / "missing API key" → Auth failure. See Authentication Failure Recovery.
• Unknown subcommand or flag / unexpected output → Possible version mismatch. See Version Compatibility.

Dune CLI

A command-line interface for Dune -- the leading blockchain data platform. Use it to write and execute DuneSQL queries against on-chain data, discover datasets, search documentation, and monitor credit usage.

Authentication

All commands except docs search require authentication via a Dune API key. The key is resolved in this priority order: