# surf

Connects crypto data to your agent with 100+ commands across 14 domains. It queries real-time token prices, wallet balances, and DeFi metrics.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 4100 installs · ★ 74
- Author: asksurf-ai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/asksurf-ai/surf-skills/tree/HEAD/skills/surf/SKILL.md
- Updated: 2026-07-27
- HTML: https://affpapa.org/en/nevibecode/skills/surf

## What it does

The skill connects the agent to the surf CLI via bash. It covers 14 data domains across 40+ chains. Data sources exceed 200 providers, spanning spot prices, wallet activity, prediction markets, and DeFi protocols.

Every session begins with surf install and surf sync. These update the CLI binary and cached API specs. The skill can also insert a 20-line routing block into AGENTS.md or CLAUDE.md. That keeps the model focused on live blockchain data.

CLI flags differ between commands. Flags like --symbol or --token-slug are not interchangeable, so the agent must run surf <command> --help before building a query. All API outputs arrive as untrusted external data. The agent treats them as plain facts and must never execute instructions nested inside response fields.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add asksurf-ai/surf-skills --skill surf -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/surf/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/surf/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add asksurf-ai/surf-skills --skill surf -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/surf/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add asksurf-ai/surf-skills --skill surf -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/surf/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install asksurf-ai/surf-skills surf
```

2. **Manually: put the files in place**
- File: `.github/skills/surf/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add asksurf-ai/surf-skills --skill surf -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/asksurf-ai/surf-skills --path skills/surf
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/surf/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add asksurf-ai/surf-skills --skill surf -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/asksurf-ai/surf-skills/tree/HEAD/skills/surf/SKILL.md

## When to use it
- fetch real-time token prices and DEX trade volume
- inspect crypto wallet balances, labels, and transfers
- check prediction market odds on Polymarket and Kalshi
- run on-chain SQL queries across 40+ blockchains

## Example prompts
- Fetch wallet balances and recent transactions with surf wallet-detail
- Find current token price candles and liquidity using surf dex-ohlcv
- Look up active prediction odds via surf polymarket-markets

## Similar
- [crypto-report](https://affpapa.org/en/nevibecode/skills/crypto-report.md) — skill · 4700 installs
- [digital-assets](https://affpapa.org/en/nevibecode/skills/digital-assets.md) — skill · 683 installs
- [nansen-defi-positions](https://affpapa.org/en/nevibecode/skills/nansen-defi-positions.md) — skill · 404 installs
- [emblem-ai-agent-wallet](https://affpapa.org/en/nevibecode/skills/emblemcompany-emblem-ai-agent-wallet.md) — skill · 8700 installs
- [okx-defi](https://affpapa.org/en/nevibecode/skills/okx-defi.md) — skill · 9800 installs
- [okx-cex-earn](https://affpapa.org/en/nevibecode/skills/okx-cex-earn.md) — skill · 9200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md