Agent skill

Surf Crypto Data API

by BlockRunAI in 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.

MITAuto-check passedBusiness, Finance & HR

Install Surf Crypto Data API

skills CLI
$ npx skills add BlockRunAI/blockrun-mcp --skill surf -a claude-code

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

GitHub CLI
$ gh skill install BlockRunAI/blockrun-mcp 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/blockrun-mcp.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/

Facts

Skill name
surf
GitHub stars
392
Token cost
~1.7k tokens
SKILL.md length
537 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Routes crypto market, on-chain, wallet and prediction-market lookups to the Surf data API through a local ClawRouter, paid per call.

  • Pulling centralized or decentralized exchange market data for a token
  • SKILL.md covers Where each former Surf…, What has NO replacement on…, Worked example — what a former… and Reference
  • Calls curl; reaches blockrun.ai
  • Running SQL against on-chain tables for a chain such as Base or Ethereum

What it does

This skill points the agent at Surf, a paid crypto-data HTTP API that ClawRouter exposes on the local machine at port 8402 under /v1/surf/. It lists 83 endpoints across 12 domains: centralized and decentralized exchange markets, SQL over more than 80 on-chain ClickHouse tables on chains such as Ethereum, Base, Arbitrum, BSC, TRON, HyperEVM and Tempo, a set of over 100M labeled wallets, Polymarket and Kalshi prediction markets, social and news feeds, project and DeFi metrics, token analytics, search and venture fund data.

Calls go through the local ClawRouter instead of the browser or a web fetch tool. Each request is paid for with an x402 USDC micropayment from the local wallet, or from BlockRun account credit when an API key is configured, and no Surf account or Surf API key is needed. The skill quotes a flat per-call price of $0.0075 on the API-key rail and on Solana and $0.0085 on Base, and says a 402 quote from the wallet rail overrides its own table if the two disagree.

When your agent uses it

  • Pulling centralized or decentralized exchange market data for a token
  • Running SQL against on-chain tables for a chain such as Base or Ethereum
  • Checking Polymarket or Kalshi prediction-market prices
  • Researching wallet labels, DeFi project metrics or venture fund activity

Example prompts

  • “List the labeled wallets that bought the most USDC on Base last week.”
  • “Show current Polymarket and Kalshi markets about the next US interest rate decision.”
  • “Pull the daily trading volume of the top DeFi projects on Arbitrum.”
  • “Search news and social chatter about the Solana ecosystem this week.”

Requirements

  • ClawRouter running locally on port 8402
  • A local wallet holding USDC for x402 payments, or a BlockRun API key

What it can do on your machine

Read from SKILL.md and the folder at commit a7a9b3c. 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

    Hosts in commands or code, which the agent is likely to contact:

    • blockrun.ai

    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 Crypto Data API loads about 1.7k tokens when it runs. Until then it costs about 102 tokens; SKILL.md has 537 words of instructions outside code blocks.

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

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/blockrun-mcp at commit a7a9b3c, republished under its MIT licence (© BlockRunAI). 537 words, ~1,701 tokens.

Download SKILL.mdSave it as .claude/skills/surf/SKILL.md (or your agent's skills folder).
name
surf
description
Surf (asksurf.ai) is RETIRED on BlockRun and the blockrun_surf tool was REMOVED in 0.49.0 — the gateway has answered every /v1/surf/* path with HTTP 410 endpoint_retired since 2026-09-06. Use this skill to route a former Surf question (on-chain SQL, wallet labels and net worth, CEX order books, social mindshare, news) to the tool that still serves it, and to say plainly what has no replacement yet.
triggers
surf, asksurf, crypto data, on-chain sql, clickhouse crypto, wallet labels, wallet net worth, smart followers, ct mindshare, social mindshare, kol search…

Surf — retired on BlockRun (2026-09-06)

Surf (asksurf.ai) is no longer served through BlockRun. Since 2026-09-06 the gateway answers every /v1/surf/* path with:

HTTP 410
{"error":{"code":"endpoint_retired","message":"The Surf data endpoints are retired. We are looking for a new vendor in this space and expect to publish a replacement under /api/v1/."},
 "retired_on":"2026-09-06",
 "alternatives":[{"for":"crypto, equity, FX and commodity prices","endpoint":"/api/v1/crypto/price"},
                 {"for":"protocol TVL and yields","endpoint":"/api/v1/defillama/*"},
                 {"for":"prediction markets","endpoint":"/api/v1/pm/*"},
                 {"for":"DEX quotes and swaps","endpoint":"/api/v1/zerox/*"}]}

Verified live 2026-09-08 with an unauthenticated GET (a 410 is free to fetch). sol.blockrun.ai answers 404 on the same paths, and /api/openapi no longer lists any Surf route. No 402 is ever issued, so no payment can be made.

blockrun_surf was removed from the server in 0.49.0 and is no longer one of the <!-- br:mcp.tools -->19<!-- /br:mcp.tools --> tools: a tool that can only return an error is not worth the schema every agent carries on every turn. An MCP client will answer an unknown-tool error if a config still names it. Nothing can be charged either way. Do not describe this as a temporary outage — it is not; route the question with the table below.

Where each former Surf capability lives now

The user wants…Surf used to beUse nowCost
BTC/ETH/any coin price, OHLC historymarket/price, exchange/klinesblockrun_price action:"price" / "history" category:"crypto"FREE
FX, gold, oilmarket/priceblockrun_price category:"fx" / "commodity"FREE
Fear & Greed, market ranking by capmarket/fear-greed, market/rankingblockrun_price action:"list" for the symbol universe; no sentiment index on BlockRunFREE / none
DEX pair, liquidity, volume, token by contracttoken/dex-trades, search/projectblockrun_dexFREE
Token price by contract addressmarket/priceblockrun_defi path:"prices/{coins}"$0.001 + fee
Protocol / chain TVL, yield rankingsproject/defi/ranking, onchain/yield/rankingblockrun_defi path:"protocols" / "chains" / "yields"$0.005 + fee
Polymarket / Kalshi markets, prices, positionsprediction-market/*, search/polymarket, search/kalshiblockrun_markets — see skills/prediction-markets/SKILL.md$0.0075 + fee
Who is this Polymarket wallet, and which wallets are theirswallet/detail, wallet/labels/batch (for Polymarket traders only)blockrun_markets polymarket/wallet/identity/{wallet} + polymarket/wallet/{address}/cluster$0.0075 + fee
Gas price, a transaction, a balance, a contract readonchain/gas-price, onchain/txblockrun_rpc (eth_gasPrice, eth_getTransactionByHash, eth_getBalance, eth_call) — see skills/rpc/SKILL.md$0.002 + fee
Web / news searchsearch/web, search/news, news/feedblockrun_exa (neural) or blockrun_search (Grok Live Search, web + X + news)$0.01 + fee / $0.025 × results

"fee" is the gateway's flat network fee — $0.001 per call on Base today; the Solana gateway quotes the base alone; the account rail charges no fee.

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

What has NO replacement on BlockRun yet

Say so plainly rather than substituting something that answers a different question:

  • Raw on-chain SQL over ClickHouse (onchain/sql, onchain/query, onchain/schema)
  • Wallet labels and net worth across 13 chains for arbitrary addresses (wallet/labels/batch, wallet/net-worth, wallet/protocols, wallet/history). Only Polymarket traders are covered, via blockrun_markets identity/cluster above.
  • CEX order books, perp snapshots, funding history, long/short ratio, options skew (exchange/*, market/options, market/futures)
  • ETF flows, liquidation charts, on-chain indicators (market/etf, market/liquidation/*, market/onchain-indicator)
  • Social / CT intelligence — mindshare, smart followers, KOL search, tweet search (social/*, search/social/*)
  • Tokenomics and unlock schedules, token holders and transfers (token/*)
  • VC fund portfolios and rankings (fund/*)
  • Bridge rankings, airdrop search, project profiles (onchain/bridge/ranking, search/airdrop, project/detail)
  • Webpage-to-markdown (web/fetch)

The gateway says a new vendor is pending and that the replacement will be published under /api/v1/ and listed at https://blockrun.ai/api/openapi. Check there before promising any of the above.

Worked example — what a former Surf request looks like now

"Is this whale wallet labeled, and what does it hold?" (was 4 Surf calls, $0.034)

ts
// If it is a Polymarket trader — identity, linked wallets, P&L:
blockrun_markets({ path: "polymarket/wallet/identity/0xWHALE" })
blockrun_markets({ path: "polymarket/wallet/0xWHALE/cluster" })
blockrun_markets({ path: "polymarket/wallet/pnl/0xWHALE" })

// For any address — current native + token balances via raw RPC (free tools first):
blockrun_rpc({ network: "ethereum", method: "eth_getBalance", params: ["0xWHALE", "latest"] })

Cross-chain labels (CEX / MEV / bridge) and a net-worth time series are not available on BlockRun right now — tell the user that. blockrun_surf no longer exists.

Reference

© BlockRunAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/surf of BlockRunAI/blockrun-mcp.

Open the folder on GitHubat commit a7a9b3c

Compare with similar skills

Surf Crypto Data API 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 Crypto Data API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Surf Crypto Data API this skillBlockRunAI/blockrun-mcp392—~1.7kAutomated safety check: PassMIT
Predexon Prediction Market DataBlockRunAI/ClawRouter6.6k—~4.7kAutomated safety check: PassMIT
SurfBlockRunAI/ClawRouter6.6k—~4kAutomated safety check: PassMIT
Minara Crypto Trading and WalletMinara-AI/minara-skills356—~5.7kAutomated safety check: PassNone
Opensea Tool SDKBankrBot/skills1.2k—~3.1kAutomated safety check: PassMIT
Alchemy Agentic Gatewaymoonpay/skills113—~2.1kAutomated safety check: NotesMIT

Similar skills

  • Predexon Prediction Market Data

    BlockRunAI/ClawRouter

    Reads structured prediction market data for Polymarket, Kalshi and other venues through a local BlockRun gateway: markets, search, leaderboards, wallet analytics and odds.

    6.6k GitHub stars~4.7k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Surf

    BlockRunAI/ClawRouter

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

    6.6k GitHub stars~4k tokensUpdated 2 days ago
    Business, Finance & HRAuto-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
  • Opensea Tool SDK

    BankrBot/skills

    Build, register, and gate AI-callable tool endpoints using the OpenSea Tool Registry (ERC-8257) on Base.

    1.2k GitHub stars~3.1k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • A skill your agent uses when accessing Alchemy APIs for RPC calls, token balances, NFT metadata, asset transfers, transaction simulation, or Alchemy-specific features.

    113 GitHub stars~2.1k tokensUpdated 27 days ago
    Backend & APIsAuto-check: notes
  • 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

More from BlockRunAI/blockrun-mcp

All 17 skills in this repo
  • Signal To Trade Demo

    BlockRunAI/blockrun-mcp

    Prepare or run a polished BlockRun trading demo that discovers a current Polymarket market, combines live price, probability history, smart-money, and liquidity evidence into a balanced signal…

    392 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Blockrun

    BlockRunAI/blockrun-mcp

    Pay-per-call access to AI models, real-time data, media generation and multi-chain RPC over x402 micropayments (USDC on Base or Solana), or a BlockRun account API key.

    392 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed
  • Blockrun Debug

    BlockRunAI/blockrun-mcp

    A skill your agent uses when the BlockRun MCP server (@blockrun/mcp) is installed but misbehaving — 'Failed to connect', spawn npx ENOENT, blockrun missing from claude mcp list, HTTP 402 /…

    392 GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Blockrun Setup

    BlockRunAI/blockrun-mcp

    A skill your agent uses when asked to install, add, configure, or set up the BlockRun MCP server (@blockrun/mcp) in Claude Code, Claude Desktop, Cursor, Windsurf, Codex CLI, Grok or another MCP…

    392 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Blockrun Upgrade

    BlockRunAI/blockrun-mcp

    A skill your agent uses when the BlockRun MCP server prints 'Update available', when asked to upgrade, update, or pin @blockrun/mcp, when a fix 'should be in the new version' but the client still…

    392 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • 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
    Auto-check passed

Questions about Surf Crypto Data API

What does Surf Crypto Data API do?

Routes crypto market, on-chain, wallet and prediction-market lookups to the Surf data API through a local ClawRouter, paid per call. This skill points the agent at Surf, a paid crypto-data HTTP API that ClawRouter exposes on the local machine at port 8402 under /v1/surf/. It lists 83 endpoints across 12 domains: centralized and decentralized exchange markets, SQL over more than 80 on-chain ClickHouse tables on chains such as Ethereum, Base, Arbitrum, BSC, TRON, HyperEVM and Tempo, a set of over 100M labeled wallets, Polymarket and Kalshi prediction markets, social and news feeds, project and DeFi metrics, token analytics, search and venture fund data.

When should I use Surf Crypto Data API?

Surf Crypto Data API fits situations like: pulling centralized or decentralized exchange market data for a token; running SQL against on-chain tables for a chain such as Base or Ethereum; checking Polymarket or Kalshi prediction-market prices; researching wallet labels, DeFi project metrics or venture fund activity.

How do I install Surf Crypto Data API in Claude Code?

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

How do I install Surf Crypto Data API in Codex?

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

Can I use Surf Crypto Data API 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/blockrun-mcp --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 Crypto Data API need to run?

Going by SKILL.md and its folder, Surf Crypto Data API needs the command-line tools its instructions call (curl). Our summary lists: ClawRouter running locally on port 8402; A local wallet holding USDC for x402 payments, or a BlockRun API key.

Does Surf Crypto Data API access the network?

SKILL.md names 1 domain. In commands or code: blockrun.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Surf Crypto Data API 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 Crypto Data API use?

Surf Crypto Data API is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Surf Crypto Data API use?

About 1.7k tokens (SKILL.md is roughly 6.8k 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 Crypto Data API?

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

Who maintains Surf Crypto Data API?

BlockRunAI (a GitHub organization) maintains it in BlockRunAI/blockrun-mcp, which has 392 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 6, 2026.

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