Surf Skills
Surf Skills: Give your AI agent access to all crypto data — prices, wallets, social, on-chain, prediction markets. One skill, 83+ endpoints.
Last verified:
What is Surf Skills?
Surf Skills is an AI agent skill that gives AI coding agents direct access to comprehensive crypto data across 40+ blockchains and 200+ data sources. It teaches AI agents how to use the Surf CLI correctly and efficiently, enabling them to fetch live crypto data including prices, wallet intelligence, social analytics, on-chain data, and prediction markets simply by asking in natural language. The skill works with any agent that supports the skills protocol including Claude Code, Codex, and similar platforms.
Key features include access to 83+ API endpoints across 12 domains covering market data (prices, rankings, technical indicators, fear & greed, liquidations, futures, options, ETFs), exchange data (order books, candlesticks, funding rates), wallet intelligence (balances, transfers, DeFi positions, net worth, labels), social analytics (Twitter/X profiles, posts, followers, mindshare, sentiment), token data (holders, DEX trades, transfers, unlock schedules), project profiles, prediction markets (Polymarket and Kalshi), on-chain data (transactions, SQL queries, gas prices), and news/search. The skill automatically handles discovery, authentication, and data fetching.
Surf Skills is designed for AI coding agents, developers building crypto applications, and crypto natives who need research and market analysis. Installation is done via npx skills add asksurf-ai/surf-skills --skill surf. The skill has 2.8K installs globally and is ranked #23 on skill platforms.
Surf Skills pricing
Pricing model: Freemium
Free tier: No API key required, every IP gets 30 free credits per day. Paid plans: Free plan at $0/month with limited access (Ask: Limited usage-based, Research: 1 per day up to 2 per week). Light plan at $15/month with unlimited Ask and 25 Research per month (up to 5 per day). Pro plan at $39/month with unlimited Ask and 100 deep analyses per 2 weeks. Annual Pro includes exclusive Limited Edition NFT. For unlimited CLI access, set API key via surf auth command or SURF_API_KEY environment variable.
Surf Skills pros
- Access to 40+ blockchains in one skill
- 200+ data sources unified access
- 83+ API endpoints available
- No API key required to get started
- 30 free credits per day per IP
- Works with Claude Code, Codex, and other skills-compatible agents
- Automatic endpoint discovery
- Handles authentication automatically
- JSON output for structured processing
- Natural language to API endpoint mapping
- Wallet intelligence including net worth and labels
- Social analytics with sentiment and mindshare
- Prediction markets from Polymarket and Kalshi
- On-chain SQL query capability
- Market data includes futures options and ETFs
- Fear and greed index access
- DEX trade data available
- Token unlock schedule tracking
- DeFi TVL and protocol metrics included
Surf Skills cons
- Requires Surf CLI installation as prerequisite
- Only 30 free credits per day without API key
- API key needed for unlimited access
- Limited documentation on error handling
- Chain name conventions can be tricky
- Pagination handling requires skill
- Best suited for crypto-focused use cases
- Requires skills protocol support in agent
Frequently asked questions about Surf Skills
What is Surf Skill?
Surf Skill is an instruction package that teaches AI coding agents how to use the Surf CLI correctly and efficiently. It gives your AI agent direct access to crypto market data, wallet intelligence, social analytics, prediction markets, and on-chain data across 40+ blockchains and 200+ data sources with one skill and 83+ endpoints.
How do I install Surf Skill?
Install with the command: npx skills add asksurf-ai/surf-skills --skill surf. This works with any agent that supports the skills protocol including Claude Code, Codex, and similar platforms. You also need to install the Surf CLI first using: curl -fsSL https://agent.asksurf.ai/cli/releases/install.sh | sh
Do I need an API key to use Surf?
No API key is required to get started. Every IP gets 30 free credits per day — just install and go. For unlimited access, you need to set your API key using surf auth (persistent, recommended) or export SURF_API_KEY=your-api-key as an environment variable.
What data domains does Surf cover?
Surf covers Market (prices, rankings, technical indicators, fear & greed, liquidations, futures, options, ETFs), Exchange (order books, candlesticks, funding rates, long/short ratios), Wallet (balances, transfers, DeFi positions, net worth, labels), Social (Twitter/X profiles, posts, followers, mindshare, sentiment), Token (holders, DEX trades, transfers, unlock schedules), Project (profiles, DeFi TVL, protocol metrics), Prediction Markets (Polymarket and Kalshi), On-chain (transactions, SQL queries, gas prices, bridge and yield rankings), and News & Search.
What does the skill teach the agent to do?
The surf skill teaches an agent to: 1) Run surf sync before discovery, 2) Use surf list-operations and surf <command> --help to find the right endpoint, 3) Prefer JSON output with -o json -f body.data for structured downstream processing, 4) Match user intent to the correct domain (market, wallet, social, token, onchain, etc.), and 5) Handle pagination, chain name conventions, and common gotchas.
What is the difference between Surf Skill and Surf CLI?
Surf Skill is installed 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 is a standalone command-line tool for terminal-based research, scripting, and automation. The Skill handles discovery, authentication, and data fetching automatically when you ask natural language questions.
How do I get structured JSON output from Surf?
Use the -o json -f body.data flags with your commands. For example: surf market-price --symbol BTC -o json -f body.data or surf wallet-detail --address 0x1234... -o json -f body.data. This is recommended for scripts and agents for structured downstream processing.
What are some common Surf CLI commands?
Common commands include: surf market-price --symbol BTC (market data), surf wallet-detail --address 0x1234... (wallet intelligence), surf social-user --handle vitalikbuterin (social lookup), surf search-project --q aave (project search). Always run surf sync before first use in a session and use surf list-operations -g to discover available commands.
How many installs does Surf Skill have?
Surf Skill has 2.8K installs and is ranked #23 globally on skill platforms like llmbase.ai.
What is the difference between Instant and Deep Research modes?
Instant mode is for quick questions with direct, simple, quick checks output style — saves time and clears doubts fast, typical for questions like 'What's the news on BTC today?'. Deep Research mode is for multi-dimensional input with structured reports including charts and conclusions, providing high depth and breadth for decision-making, typical for questions like 'Summarize last week's BTC sentiment and on-chain flows'.