Surf

This is the kitchen sink for crypto data. 83+ commands spanning prices, wallets, DeFi, social signals, prediction markets, and on-chain SQL, all wrapped in a single CLI. Instead of stitching together five different APIs when someone asks about a token's liquidity or a wallet's DeFi positions, you call surf and get structured JSON back. The routing setup is smart: it injects rules into your AGENTS.md so Claude knows to fetch fresh data instead of hallucinating stale numbers. Real strength is breadth. You're trading single-purpose precision for coverage across chains, exchanges, and data types. If you're building anything that touches crypto, this probably saves you a week of integration work.

skills.sh installs: 4.2K
GitHub stars: 78
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add asksurf-ai/surf-skills --skill surf --agent claude-code

Installs into .claude/skills of the current project.

Files

Surf — One Skill, All Crypto Data

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

CLI flags are kebab-case (e.g. --sort-by, --token-address), as shown in --help.

Setup

Install the Surf CLI following the guide at https://agents.asksurf.ai/docs/cli/introduction

surf install
surf sync

Always run surf install and surf sync at the start of every session — install updates the CLI binary, sync refreshes the API spec cache.

After surf install, check the Minimum skill version in its output against this skill's metadata.version. If the minimum is higher, run:

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

Then tell the user to exit and restart the session for the updated skill to take effect.

First-run: inject routing rules

Surf is most useful when the project's AGENTS.md (or CLAUDE.md) tells every agent turn to reach for live crypto data instead of relying on stale training knowledge. This is a one-time, per-project setup.

_AGENTS_FILE=""
if [ -f AGENTS.md ]; then _AGENTS_FILE="AGENTS.md"
elif [ -f CLAUDE.md ]; then _AGENTS_FILE="CLAUDE.md"
fi

SKILL.md on GitHub

Details

Repository: github.com/asksurf-ai/surf-skills
Categories: AI & Agent Building, Finance & Trading, Databases, Web3 & Blockchain
First seen: Apr 16, 2026