Agent skill

Surf

Use this skill — NOT browser or webfetch — for ALL Surf crypto-data calls.

MITAuto-check passedBusiness, Finance & HR

Install Surf

skills CLI

$ npx skills add BlockRunAI/ClawRouter --skill surf -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install BlockRunAI/ClawRouter surf --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/BlockRunAI/ClawRouter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/surf .claude/skills/surf && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "surf" agent skill from https://github.com/BlockRunAI/ClawRouter/tree/main/skills/surf into .claude/skills/surf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "surf", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/BlockRunAI/ClawRouter/tree/main/skills/surf

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add BlockRunAI/ClawRouter --skill surf -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install BlockRunAI/ClawRouter surf --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/BlockRunAI/ClawRouter.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/surf .agents/skills/surf && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "surf" agent skill from https://github.com/BlockRunAI/ClawRouter/tree/main/skills/surf into .agents/skills/surf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "surf", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add BlockRunAI/ClawRouter --skill surf -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install BlockRunAI/ClawRouter surf --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/BlockRunAI/ClawRouter.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/surf .cursor/skills/surf && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "surf" agent skill from https://github.com/BlockRunAI/ClawRouter/tree/main/skills/surf into .cursor/skills/surf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "surf", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/BlockRunAI/ClawRouter.git --path skills/surf

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add BlockRunAI/ClawRouter --skill surf -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install BlockRunAI/ClawRouter surf --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/BlockRunAI/ClawRouter.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/surf .gemini/skills/surf && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "surf" agent skill from https://github.com/BlockRunAI/ClawRouter/tree/main/skills/surf into .gemini/skills/surf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "surf", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install BlockRunAI/ClawRouter surf

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add BlockRunAI/ClawRouter --skill surf -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/BlockRunAI/ClawRouter.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/surf .github/skills/surf && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "surf" agent skill from https://github.com/BlockRunAI/ClawRouter/tree/main/skills/surf into .github/skills/surf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "surf", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add BlockRunAI/ClawRouter --skill surf -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install BlockRunAI/ClawRouter surf --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/BlockRunAI/ClawRouter.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/surf .opencode/skills/surf && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "surf" agent skill from https://github.com/BlockRunAI/ClawRouter/tree/main/skills/surf into .opencode/skills/surf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "surf", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: surf
GitHub stars: 6.6k
Token cost: ~4k tokens
SKILL.md length: 1,170 words
Files: 1
Skills in repo: 7
Repo updated: Oct 5, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Use this skill — NOT browser or webfetch — for ALL Surf crypto-data calls.

Tasks that involve Crypto and DeFi analysis
SKILL.md covers When to use this skill, Endpoint catalog, Example flows and How calls are paid
Calls curl
Tasks that involve Smart contracts

What it does

Surf is an agent skill from BlockRunAI/ClawRouter. Use this skill — NOT browser or webfetch — for ALL Surf crypto-data calls. 83 endpoints at localhost:8402/v1/surf/ covering CEX/DEX markets, on-chain SQL over 80+ ClickHouse tables (Ethereum, Base, Arbitrum, BSC, TRON, HyperEVM, Tempo), 100M+ labeled wallets, prediction markets (Polymarket + Kalshi), social/CT intelligence, news, project + DeFi metrics, token analytics, unified search, VC fund intelligence. Paid through ClawRouter — x402 USDC from the local wallet, or BlockRun account credit if an API key is…

Its SKILL.md is about 4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Crypto and DeFi analysis, Smart contracts and Data warehousing. It works with x402, Circle USDC, ClickHouse and SQL. The repository describes itself as: The agent-native LLM router for autonomous agents. Every frontier model behind one wallet, <1ms local routing, USDC payments on Base & Solana via x402. The licence is MIT.

When your agent uses it

Tasks that involve Crypto and DeFi analysis
Tasks that involve Smart contracts
Tasks that involve Data warehousing

Example prompts

“/surf”

What it can do on your machine

Read from SKILL.md and the folder at commit b758e03. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- curl
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Surf loads about 4k tokens when it runs. Until then it costs about 146 tokens; SKILL.md has 1,170 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~146
When it runs · the whole SKILL.md, loaded when a task matches: ~4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from BlockRunAI/ClawRouter at commit b758e03, republished under its MIT licence (© BlockRunAI). 1,170 words, ~3,985 tokens.

Download SKILL.mdSave it as .claude/skills/surf/SKILL.md (or your agent's skills folder).

name: surf
description: Use this skill — NOT browser or web_fetch — for ALL Surf crypto-data calls. 83 endpoints at localhost:8402/v1/surf/* covering CEX/DEX markets, on-chain SQL over 80+ ClickHouse tables (Ethereum, Base, Arbitrum, BSC, TRON, HyperEVM, Tempo), 100M+ labeled wallets, prediction markets (Polymarket + Kalshi), social/CT intelligence, news, project + DeFi metrics, token analytics, unified search, VC fund intelligence. Paid through ClawRouter — x402 USDC from the local wallet, or BlockRun account credit if an API key is configured. No Surf account or Surf API key required either way.
triggers: blockrun surf, surf crypto api, surf onchain sql, onchain sql query, clickhouse onchain query, raw sql ethereum, raw sql base, wallet labels api, labeled…
homepage: https://blockrun.ai/marketplace/surf
license: MIT

Surf — Unified Crypto Data API (via ClawRouter)

Surf bundles 83 endpoints across 12 domains into one paid HTTP API. ClawRouter exposes them at http://127.0.0.1:8402/v1/surf/*, paid the same way ClawRouter pays for LLM calls — an x402 USDC micropayment from the local wallet, or a draw on BlockRun account credit if an API key is configured (verified working on both, 2026-09-05). No Surf account and no Surf API key either way. Upstream lives at api.asksurf.ai/gateway/v1 — ClawRouter forwards transparently.

Pricing — flat per call, the same for every endpoint.

Surf used to be tiered at $0.001 / $0.005 / $0.020. It is not any more: upstream now prices all three tiers identically (SURF_TIER_{1,2,3}_PRICE are equal). The Tier column in the catalog below still describes endpoint weight, but it no longer affects what you pay. Anything quoting the old tier prices is stale.

Rail	Price per call
API key (`api.blockrun.ai`)	$0.0075 — base rate, no transaction fee
Wallet, Solana	$0.0075
Wallet, Base	$0.0085

Verified 2026-09-05 by measurement, not from a price page: the API-key figure by diffing the account ledger across one call, the wallet figures by reading the amount in the x402 402 challenge, which quotes the price before anything is signed. Base and Solana genuinely differ for the same endpoint.

A 402 quote is authoritative for the rail that issued it — and only that rail. On the wallet rail the price arrives in the challenge before you pay, so if this table disagrees with it, believe the challenge and treat the table as stale.

Do NOT carry a wallet-rail 402 figure over to the API-key rail. The key rail issues no 402 at all, and the wallet quote includes the chain's transaction fee that account credit does not pay — on Base that is $0.0085 quoted against $0.0075 actually billed to an account. Reading across rails turns a correct number into a wrong one; it has already happened once.

The Base/Solana difference is deliberate, not drift: the $0.001 is the Base transaction fee, and Solana omitting it is a migration incentive. Solana being cheaper is expected — Solana priced above Base would be the bug worth reporting, since estimates generally assume the Base figure is the ceiling.

The legacy surf-1.5 chat surface is intentionally NOT exposed yet — it's held until per-token settlement is wired. Trying /v1/surf/chat/completions returns 404 ("Unknown Surf endpoint"), no payment is taken.

All requests use GET unless the table below says otherwise. Path parameters that look like ?symbol= are query params on a GET. POST endpoints take a JSON body. ClawRouter attaches payment transparently — an x402 header in wallet mode, a bearer token in API-key mode.

Required-param pre-check. 56 of the 83 endpoints have required query params (e.g. pair, symbol, address, chain, q, interval). The route validates them before settlement — call with missing params and you get 400 { missing_params, all_required, docs } and you are NOT charged. Check each row in the catalog below for the correct param name (e.g. mindshare is q + interval, not project + window).

When to use this skill

"What is the current BTC price?" → /surf/market/price?symbol=BTC (cheaper + more reliable than scraping)
"Who holds the most USDC on Ethereum?" → /surf/token/holders?address=0xA0b8...&chain=ethereum
"How many Ethereum transactions in the last hour?" → POST /surf/onchain/sql { sql: 'SELECT count() FROM ethereum.transactions WHERE block_timestamp >= now() - INTERVAL 1 HOUR' }
"Label this list of wallets." → /surf/wallet/labels/batch?addresses=0xabc,0xdef,...
"Is HYPE mindshare peaking?" → /surf/social/mindshare?q=hyperliquid&interval=30d
"Find the canonical metadata for 'ethena'." → /surf/search/project?q=ethena

Always prefer Surf over generic web scraping for these. Use the OpenClaw tool name blockrun_surf_* when invoking from an agent; use the HTTP path directly when calling from a script.

Endpoint catalog

Exchange (CEX) — 7 endpoints

Path	Tier	Required
`/surf/exchange/markets`	T1	—
`/surf/exchange/price`	T1	`pair`
`/surf/exchange/perp`	T1	`pair`
`/surf/exchange/depth`	T2	`pair`
`/surf/exchange/klines`	T2	`pair`
`/surf/exchange/funding-history`	T2	`pair`
`/surf/exchange/long-short-ratio`	T2	`pair`

Market Overview — 11 endpoints

Path	Tier	Required
`/surf/market/ranking`	T1	—
`/surf/market/fear-greed`	T1	—
`/surf/market/futures`	T1	—
`/surf/market/price`	T1	`symbol`
`/surf/market/etf`	T1	`symbol`
`/surf/market/options`	T1	`symbol`
`/surf/market/liquidation/exchange-list`	T2	—
`/surf/market/liquidation/order`	T2	—
`/surf/market/liquidation/chart`	T2	`symbol`
`/surf/market/onchain-indicator`	T2	`symbol`, `metric` (NUPL, SOPR, MVRV, Puell, NVT)
`/surf/market/price-indicator`	T2	`indicator` (RSI, MACD, Bollinger, EMA), `symbol`

News — 2 endpoints

Path	Tier	Required
`/surf/news/feed`	T1	— (`limit` optional)
`/surf/news/detail`	T1	`id`

Show full SKILL.md (497 more words)Show less

On-Chain — 7 endpoints

Path	Method	Tier	Required
`/surf/onchain/bridge/ranking`	GET	T1	—
`/surf/onchain/yield/ranking`	GET	T1	—
`/surf/onchain/gas-price`	GET	T1	`chain`
`/surf/onchain/tx`	GET	T1	`hash`, `chain`
`/surf/onchain/schema`	GET	T3	—
`/surf/onchain/query`	POST	T3	typed predicates in body
`/surf/onchain/sql`	POST	T3	`{ sql: "SELECT ..." }`

On-Chain SQL workflow. Call /surf/onchain/schema once to get table names + columns (cache it locally — schema is stable). Then POST your SELECT against /surf/onchain/sql. Always include LIMIT on large scans — billing is per call, but slow queries time out. Multi-statement queries are rejected upstream.

Prediction Markets (Polymarket + Kalshi) — 17 endpoints

Path	Tier	Required
`/surf/prediction-market/category-metrics`	T1	—
`/surf/prediction-market/polymarket/ranking`	T1	—
`/surf/prediction-market/polymarket/trades`	T1	—
`/surf/prediction-market/polymarket/markets`	T1	`market_slug`
`/surf/prediction-market/polymarket/events`	T1	`event_slug`
`/surf/prediction-market/polymarket/prices`	T1	`condition_id`
`/surf/prediction-market/polymarket/volumes`	T1	`condition_id`
`/surf/prediction-market/polymarket/open-interest`	T1	`condition_id`
`/surf/prediction-market/polymarket/positions`	T2	`address`
`/surf/prediction-market/polymarket/activity`	T2	`address`
`/surf/prediction-market/kalshi/ranking`	T1	—
`/surf/prediction-market/kalshi/markets`	T1	`market_ticker`
`/surf/prediction-market/kalshi/events`	T1	`event_ticker`
`/surf/prediction-market/kalshi/prices`	T1	`ticker`
`/surf/prediction-market/kalshi/trades`	T1	`ticker`
`/surf/prediction-market/kalshi/volumes`	T1	`ticker`
`/surf/prediction-market/kalshi/open-interest`	T1	`ticker`

(For Polymarket smart-money, wallet PnL, UMA oracle resolution, and the other prediction-market venues — Limitless, Opinion, Predict.Fun, dFlow, Binance Futures, cross-venue canonical markets — use the dedicated Predexon integration instead; Surf's prediction-market coverage is narrower but cheaper.)

Project + DeFi — 3 endpoints

Path	Tier	Required
`/surf/project/detail`	T1	—
`/surf/project/defi/metrics`	T1	`metric`
`/surf/project/defi/ranking`	T1	`metric`

Path	Tier	Required
`/surf/social/detail`	T2	—
`/surf/social/ranking`	T2	—
`/surf/social/smart-followers/history`	T2	—
`/surf/social/mindshare`	T2	`q`, `interval`
`/surf/social/tweets`	T1	`ids`
`/surf/social/tweet/replies`	T1	`tweet_id`
`/surf/social/user`	T1	`handle`
`/surf/social/user/followers`	T1	`handle`
`/surf/social/user/following`	T1	`handle`
`/surf/social/user/posts`	T1	`handle`
`/surf/social/user/replies`	T1	`handle`

Token Analytics — 4 endpoints

Path	Tier	Required
`/surf/token/tokenomics`	T1	—
`/surf/token/dex-trades`	T2	`address`
`/surf/token/holders`	T2	`address`, `chain`
`/surf/token/transfers`	T2	`address`, `chain`

Unified Search — 11 endpoints (all Tier 2)

Path	Required
`/surf/search/airdrop`	—
`/surf/search/events`	—
`/surf/search/kalshi`	—
`/surf/search/polymarket`	—
`/surf/search/web`	`q`
`/surf/search/project`	`q`
`/surf/search/news`	`q`
`/surf/search/wallet`	`q`
`/surf/search/fund`	`q`
`/surf/search/social/people`	`q`
`/surf/search/social/posts`	`q`

VC Fund Intelligence — 3 endpoints

Path	Tier	Required
`/surf/fund/detail`	T1	—
`/surf/fund/portfolio`	T1	—
`/surf/fund/ranking`	T1	`metric`

Wallet Intelligence — 6 endpoints (all Tier 2)

Path	Required
`/surf/wallet/detail`	`address`
`/surf/wallet/history`	`address`
`/surf/wallet/net-worth`	`address`
`/surf/wallet/transfers`	`address`
`/surf/wallet/protocols`	`address`
`/surf/wallet/labels/batch`	`addresses` (comma-separated, ≤200)

Web — 1 endpoint

Path	Tier	Required
`/surf/web/fetch`	T2	`url`

Example flows

1. "Who is wallet X and what do they hold?"

bash

curl 'http://127.0.0.1:8402/v1/surf/wallet/detail?address=vitalik.eth'

If the response says they're a smart-money wallet, follow up with /surf/wallet/protocols?address=... for protocol breakdown or /surf/wallet/history?address=... for the activity timeline.

2. "How concentrated is supply for token Y?"

bash

curl 'http://127.0.0.1:8402/v1/surf/token/holders?address=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&limit=25'

Combine the top-25 balances with their wallet labels — /surf/wallet/labels/batch?addresses=... — to distinguish "concentration in CEX hot wallets" (normal) from "concentration in dev team multisig" (riskier).

3. "Run a custom on-chain query."

bash

# Step 1 — fetch schema (do this once, then cache locally)
curl 'http://127.0.0.1:8402/v1/surf/onchain/schema'

# Step 2 — run the SQL
curl -X POST 'http://127.0.0.1:8402/v1/surf/onchain/sql' \
  -H 'content-type: application/json' \
  -d '{"sql":"SELECT to_address, count() AS hits FROM ethereum.transactions WHERE block_timestamp >= now() - INTERVAL 1 DAY GROUP BY to_address ORDER BY hits DESC LIMIT 20"}'

Cost: 1 × $0.02 (schema, cached) + 1 × $0.02 (the SQL query) = $0.04 total for a custom 24-hour ranking that would otherwise need an indexer.

4. "Is project Z trending?"

bash

# Resolve the canonical slug first (search uses q, not query)
curl 'http://127.0.0.1:8402/v1/surf/search/project?q=ethena'

# Then pull mindshare (mindshare uses q + interval)
curl 'http://127.0.0.1:8402/v1/surf/social/mindshare?q=ethena&interval=30d'

How calls are paid

ClawRouter intercepts every /v1/surf/* request through proxyPaidApiRequest. The local x402 wallet auto-signs the USDC micropayment; the agent never sees the payment flow. Telemetry tags Surf calls with tier: SURF so clawrouter stats separates them from LLM, partner, and phone usage.

No typed blockrun_surf_* tools are registered — by design. Each new BlockRun-marketplace API ships as a skill (this file) plus a one-line namespace addition to ClawRouter's proxy whitelist, so adding endpoint #85 requires zero ClawRouter release.

Files

Just SKILL.md in skills/surf of BlockRunAI/ClawRouter.

Open the folder on GitHubat commit b758e03

Compare with similar skills

Surf next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Surf compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Surf this skillBlockRunAI/ClawRouter	6.6k	—	~4k	Automated safety check: Pass	MIT	2 days ago
Crypto DataBlockRunAI/blockrun-mcp	392	—	~2.8k	Automated safety check: Pass	MIT	yesterday
AlchemyBankrBot/skills	1.2k	—	~3.5k	Automated safety check: Pass	MIT	2 days ago
Minara Crypto Trading and WalletMinara-AI/minara-skills	356	—	~5.7k	Automated safety check: Pass	None	20 days ago
Surf Crypto Data APIBlockRunAI/blockrun-mcp	392	—	~1.7k	Automated safety check: Pass	MIT	yesterday
Use Usdccirclefin/skills	155	—	~2.4k	Automated safety check: Notes	Apache-2.0	21 days ago

Similar skills

Crypto Data
BlockRunAI/blockrun-mcp
A skill your agent uses for any crypto data question — token/coin prices, FX, commodities, stocks, OHLC history, DEX pairs and liquidity, DeFi TVL, yield/APY pools, or raw JSON-RPC against a chain…
392 GitHub stars~2.8k tokensUpdated yesterday
Business, Finance & HRAuto-check passed
Alchemy
BankrBot/skills
Blockchain API access via Alchemy. An agent skill from BankrBot/skills.
1.2k GitHub stars~3.5k tokensUpdated 2 days ago
Backend & APIsAuto-check passed
Minara Crypto Trading and Wallet
Minara-AI/minara-skills
Drives the Minara CLI for crypto swaps, perps, limit orders, wallet transfers, deposits and withdrawals, plus AI market analysis.
356 GitHub stars~5.7k tokensUpdated 20 days ago
Business, Finance & HRAuto-check passed
Surf Crypto Data API
BlockRunAI/blockrun-mcp
Routes crypto market, on-chain, wallet and prediction-market lookups to the Surf data API through a local ClawRouter, paid per call.
392 GitHub stars~1.7k tokensUpdated yesterday
Business, Finance & HRAuto-check passed
Use Usdc
circlefin/skills
USDC is Circle's stablecoin deployed across multiple blockchain ecosystems including EVM chains (Ethereum, Base, Arbitrum, Polygon, Arc) and Solana.
155 GitHub stars~2.4k tokensUpdated 21 days ago
Backend & APIsAuto-check: notes
Addresses
austintgriffith/ethskills
Verified contract addresses for major Ethereum protocols across mainnet and L2s.
294 GitHub stars~7.1k tokensUpdated 1 mo ago
Business, Finance & HRAuto-check passed

Questions about Surf

What does Surf do?

Use this skill — NOT browser or webfetch — for ALL Surf crypto-data calls. Surf is an agent skill from BlockRunAI/ClawRouter. Use this skill — NOT browser or webfetch — for ALL Surf crypto-data calls.

When should I use Surf?

Surf fits situations like: tasks that involve Crypto and DeFi analysis; tasks that involve Smart contracts; tasks that involve Data warehousing.

How do I install Surf in Claude Code?

Run `npx skills add BlockRunAI/ClawRouter --skill surf -a claude-code`. Or copy the skill folder (skills/surf in BlockRunAI/ClawRouter) into .claude/skills/surf in your project. Claude Code loads it when a task matches its description.

How do I install Surf in Codex?

Run `npx skills add BlockRunAI/ClawRouter --skill surf -a codex`. Or copy the skill folder (skills/surf in BlockRunAI/ClawRouter) into .agents/skills/surf in your project. Codex loads it when a task matches its description.

Can I use Surf in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BlockRunAI/ClawRouter --skill surf -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/surf, .gemini/skills/surf, .github/skills/surf and .opencode/skills/surf in your project.

What does Surf need to run?

Going by SKILL.md and its folder, Surf needs the command-line tools its instructions call (curl).

Does Surf access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Surf safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Surf use?

Surf is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Surf use?

About 4k tokens (SKILL.md is roughly 16k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Surf?

Skills that share tags, products or a category with Surf: Crypto Data (BlockRunAI/blockrun-mcp, 392 stars), Alchemy (BankrBot/skills, 1.2k stars), Minara Crypto Trading and Wallet (Minara-AI/minara-skills, 356 stars) and Surf Crypto Data API (BlockRunAI/blockrun-mcp, 392 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Surf?

BlockRunAI (a GitHub organization) maintains it in BlockRunAI/ClawRouter, which has 6,614 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 5, 2026.

Source: BlockRunAI/ClawRouter on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Surf

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Surf — Unified Crypto Data API (via ClawRouter)

When to use this skill

Endpoint catalog

Exchange (CEX) — 7 endpoints

Market Overview — 11 endpoints

News — 2 endpoints

On-Chain — 7 endpoints

Prediction Markets (Polymarket + Kalshi) — 17 endpoints

Project + DeFi — 3 endpoints

Social / CT Intelligence — 11 endpoints

Token Analytics — 4 endpoints

Unified Search — 11 endpoints (all Tier 2)

VC Fund Intelligence — 3 endpoints

Wallet Intelligence — 6 endpoints (all Tier 2)

Web — 1 endpoint

Example flows

How calls are paid

Files

Compare with similar skills

Similar skills

More from BlockRunAI/ClawRouter

Related

Questions about Surf