Surf Data API

surf is a global CLI for querying crypto data. Run it directly (NOT via npx surf).

CLI flags use kebab-case (e.g. --sort-by, --token-address), NOT snake_case.

Setup

Install or upgrade the Surf CLI:

surf install                    # Upgrade to latest version (if surf is already installed)
curl -fsSL https://agent.asksurf.ai/cli/releases/install.sh | sh   # First-time install
export SURF_API_KEY=<your-api-key>

Always run surf install before starting a session to ensure you have the latest commands and fixes.

CLI Usage