Introduction

Surf gives AI coding agents and developers direct access to crypto intelligence — market data, wallets, social, on-chain analytics, prediction markets, and more.

There are two ways to use it:

• Surf Skill — Install into your AI agent (Claude Code, Codex, etc.) so it automatically knows how to fetch crypto data when you ask. This is the recommended way for most users.
• Surf CLI — A standalone command-line tool for terminal-based research, scripting, and automation.

Quick Start

With an AI Agent (Recommended)

npx skills add asksurf-ai/surf-skills --skill surf

Once installed, just ask your agent things like "what's the price of ETH" or "show me the top wallets holding AAVE" — the skill handles the rest.

With the CLI Directly

curl -fsSL https://downloads.asksurf.ai/cli/releases/install.sh | sh
surf market-price --symbol BTC

No API key needed to try it — you get 30 free credits per day. For full access, get your key from agents.asksurf.ai and run surf auth --api-key sk-your-key-here to save it (stored in the OS keychain when available).

The CLI is open source — github.com/asksurf-ai/surf-cli.