Agent skill

Crypto Data

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

MITAuto-check passedBusiness, Finance & HR

Install Crypto Data

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

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

GitHub CLI
$ gh skill install BlockRunAI/blockrun-mcp crypto-data --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/crypto-data .claude/skills/crypto-data && 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
crypto-data
GitHub stars
392
Token cost
~2.8k tokens
SKILL.md length
855 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 6 steps: "What's BTC at?" — do not pay for this → "Is this token legit?" ← compound,… → "Who owns this wallet and what do they… → …
  • Any crypto data question — token/coin prices
  • SKILL.md covers Route by cost — check this…, blockrun_price — quotes &…, blockrun_dex — DEX pairs &… and blockrun_defi — TVL & yields…, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Crypto Data is an agent skill from BlockRunAI/blockrun-mcp. Use 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; also when the user asks for on-chain SQL, wallet labels/net worth, social mindshare or crypto news, so they are told plainly what BlockRun serves and what it does not. Routes across four live tools that overlap and says which one to use and which are FREE — blockrunprice (crypto/FX/commodities free, Pyth), blockrundex (free, DexScreener)…

Its SKILL.md is about 2.8k 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 and Smart contracts. It works with SQL, x402 and Circle USDC. The repository describes itself as: Live data for AI agents — search, research, markets, crypto, X/Twitter. Pay-per-call via x402 micropayments. The licence is MIT.

When your agent uses it

  • Any crypto data question — token/coin prices
  • DEX pairs and liquidity
  • Yield/APY pools
  • Raw JSON-RPC against a chain

Example prompts

  • “/crypto-data”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. "What's BTC at?" — do not pay for this
  2. "Is this token legit?" ← compound, mostly free
  3. "Who owns this wallet and what do they hold?"
  4. "Where's the best yield right now?"
  5. "Give me the macro picture"
  6. "Is gold up today?" — also free

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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

Crypto Data loads about 2.8k tokens when it runs. Until then it costs about 183 tokens; SKILL.md has 855 words of instructions outside code blocks.

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

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). 855 words, ~2,823 tokens.

Download SKILL.mdSave it as .claude/skills/crypto-data/SKILL.md (or your agent's skills folder).
name
crypto-data
description
Use 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; also when the user asks for on-chain SQL, wallet labels/net worth, social mindshare or crypto news, so they are told plainly what BlockRun serves and what it does not. Routes across four live tools that overlap and says which one to use and which are FREE — blockrun_price (crypto/FX/commodities free, Pyth), blockrun_dex (free, DexScreener), blockrun_defi (DefiLlama TVL + yields), blockrun_rpc (40 chains). blockrun_surf is retired (gateway 410 since 2026-09-06) and must not be called for data. No API keys, pay-per-call in USDC via x402.
triggers
crypto price, token price, coin price, what is btc worth, eth price, price history, ohlc, candles, stock price, forex, fx rate, commodity price, gold price…

Crypto Data

Four live tools cover crypto data and they overlap. Pick by cost first — two of them are free, and paying for a quote you could get for nothing is the most common mistake here.

A fifth tool, blockrun_surf, was removed in 0.49.0: the gateway has answered every Surf path with HTTP 410 since 2026-09-06. Do not name it; the surf skill maps each former Surf capability to where it lives now — and lists the ones (on-chain SQL, cross-chain wallet labels, social mindshare, CEX order books) that have no BlockRun source yet.

Route by cost — check this before calling anything

QuestionToolCost
What's BTC/ETH/any coin worth right now?blockrun_price action:"price" category:"crypto"FREE
Crypto OHLC historyblockrun_price action:"history" category:"crypto"FREE
FX rate / commodity (gold, oil)blockrun_price category:"fx" or "commodity"FREE
Which symbols exist?blockrun_price action:"list"FREE
DEX pair, liquidity, volume, contractblockrun_dexFREE
Stock ticker catalog (12 markets)blockrun_price action:"list" category:"stocks"FREE — quotes/history withdrawn 2026-09-05 (501)
Token price by contract addressblockrun_defi path:"prices/{coins}"$0.0020
Raw JSON-RPC on <!-- br:chains.rpc -->40<!-- /br:chains.rpc --> chainsblockrun_rpc$0.0030
Protocol TVL, chain TVL, yields/APYblockrun_defi$0.0060
Who a Polymarket wallet is, and which wallets are linked to itblockrun_markets polymarket/wallet/identity/{w}, .../cluster$0.0085
On-chain SQL, cross-chain wallet labels / net worth, social mindshare, CEX order books, ETF flows, unlocksnothing on BlockRun yet — Surf retired 2026-09-06; say so—

Every price below is what x402 actually charges on Base (the base plus the gateway's $0.001 flat fee), verified against live payment-required headers — not the base you may see in a 402 body. The Solana gateway quotes the base alone; the account rail charges no fee.

The rule: a plain crypto price or a DEX pair is free. When the question needs something the four live tools do not have — labels, SQL, social, news, unlocks — tell the user BlockRun does not serve it right now. The tool that used to (blockrun_surf) was removed in 0.49.0.

Prediction markets go to blockrun_markets (Predexon): Polymarket, Kalshi, Limitless, Opinion and Predict.Fun, plus wallet clustering, smart money and UMA. For sports odds use markets/search with { q: "NBA" } or polymarket/events with { search: "NBA" } — the dedicated sports/* routes are degraded upstream, and the bare markets route with a league filter was removed on 2026-08-04 and 404s. Route odds, positions and market history to skills/prediction-markets/SKILL.md.

blockrun_price — quotes & history (Pyth-backed)

Free for crypto, FX and commodities. Equity is catalog-only: since 2026-09-05 the gateway answers stocks price/history with a pre-payment 501 ("We do not currently serve equity prices") — nothing is charged, retrying does not help, and the user should contact hello@blockrun.ai for equity coverage. action:"list" still returns the ticker catalog for free.

ts
blockrun_price({ action: "price",   category: "crypto",    symbol: "BTC-USD" })            // FREE
blockrun_price({ action: "history", category: "crypto",    symbol: "ETH-USD",
                 resolution: "1h", from: 1750000000, to: 1750086400 })                     // FREE
blockrun_price({ action: "price",   category: "fx",        symbol: "EUR-USD" })            // FREE
blockrun_price({ action: "price",   category: "commodity", symbol: "XAU-USD" })            // FREE — gold
blockrun_price({ action: "list",    category: "crypto" })                                  // FREE — discovery
blockrun_price({ action: "list",    category: "stocks",    market: "us", query: "AAPL" })   // FREE — catalog only; price/history → 501

Stock markets: us, hk, jp, kr, gb, de, fr, nl, ie, lu, cn, ca — market is required when category:"stocks". Do not call action:"price" or "history" on stocks: the gateway does not serve equity quotes right now.

blockrun_dex — DEX pairs & liquidity (DexScreener)

Free, no payment. Use it for anything pair- or contract-shaped.

ts
blockrun_dex({ query: "SOL" })                      // search pairs
blockrun_dex({ symbol: "PEPE" })                    // search by symbol
blockrun_dex({ token: "So11111111111111111111111111111111111111112" })  // one token
blockrun_dex({ query: "WETH", chain: "base" })      // scope to a chain
Show full SKILL.md (377 more words)Show less

blockrun_defi — TVL & yields (DefiLlama)

Path-based, GET only. Base only in wallet mode; fine on an API key — sol.blockrun.ai does not serve /v1/defillama/* and answers 404, which reads like a bad path rather than a wrong chain. The tool checks the active chain and refuses with that explanation before spending the round trip; if the user needs DeFi data, switch back with blockrun_wallet action:"chain" chain:"base".

pathcostreturns
protocols$0.0060every DeFi protocol ranked by TVL
protocol/{slug}$0.0060one protocol's TVL history + chain breakdown
chains$0.0060TVL by chain
yields$0.0060yield pools with APY + TVL (large — filter client-side)
prices/{coins}$0.0020token prices by contract, e.g. base:0x8335…,coingecko:ethereum
ts
blockrun_defi({ path: "protocol/aave-v3" })
blockrun_defi({ path: "chains" })
blockrun_defi({ path: "yields" })                   // big payload — filter after
blockrun_defi({ path: "prices/coingecko:ethereum" })

blockrun_surf — removed 2026-09-06 (tool dropped in 0.49.0)

The gateway answers every /v1/surf/* path with 410 endpoint_retired (verified live 2026-09-08; sol.blockrun.ai 404s; /api/openapi lists no Surf route), so the tool was removed from the server rather than left to return an error. It is not one of the <!-- br:mcp.tools -->19<!-- /br:mcp.tools --> tools. Route former Surf questions to blockrun_price, blockrun_dex, blockrun_defi, blockrun_markets or blockrun_rpc; see skills/surf/SKILL.md for the endpoint-by-endpoint map and for what has no replacement.

blockrun_rpc — raw chain access

<!-- br:chains.rpc -->40<!-- /br:chains.rpc --> chains, one endpoint, no node, no key. $0.0030/call (batches charge per element, plus one flat fee per request). See [`skills/rpc/SKILL.md`](../rpc/SKILL.md).
ts
blockrun_rpc({ network: "base", method: "eth_blockNumber", params: [] })

Worked Examples

1. "What's BTC at?" — do not pay for this
ts
blockrun_price({ action: "price", category: "crypto", symbol: "BTC-USD" })   // FREE

Not blockrun_surf — it no longer exists (removed in 0.49.0); before 2026-09-06 it charged $0.0085 for an answer you can get free.

2. "Is this token legit?" ← compound, mostly free
ts
blockrun_dex({ token: "0xCONTRACT" })                                        // FREE — liquidity, volume, pairs, age
blockrun_defi({ path: "prices/base:0xCONTRACT" })                            // $0.0020 — is it priced by DefiLlama at all?
blockrun_rpc({ network: "base", method: "eth_call", params: [{ to: "0xCONTRACT", data: "0x18160ddd" }, "latest"] })  // totalSupply()

Start free. Only pay once the free signal says it is worth a closer look. Holder concentration and unlock schedules were Surf features and have no BlockRun source right now — say so rather than guessing.

3. "Who owns this wallet and what do they hold?"
ts
// A Polymarket trader: identity, linked wallets, P&L — via Predexon
blockrun_markets({ path: "polymarket/wallet/identity/0xWHALE" })
blockrun_markets({ path: "polymarket/wallet/0xWHALE/cluster" })
blockrun_markets({ path: "polymarket/wallet/pnl/0xWHALE" })

// Any address: balances via raw RPC
blockrun_rpc({ network: "ethereum", method: "eth_getBalance", params: ["0xWHALE", "latest"] })

Cross-chain labels (CEX / MEV / bridge), net-worth history and DeFi position breakdowns were Surf features; nothing on BlockRun serves them today.

4. "Where's the best yield right now?"
ts
blockrun_defi({ path: "yields" })          // filter by chain/TVL/APY client-side — payload is large
blockrun_defi({ path: "chains" })          // where the money actually is
5. "Give me the macro picture"
ts
blockrun_price({ action: "price", category: "crypto",    symbol: "BTC-USD" })   // FREE
blockrun_price({ action: "price", category: "commodity", symbol: "XAU-USD" })   // FREE — gold
blockrun_price({ action: "price", category: "fx",        symbol: "EUR-USD" })   // FREE
blockrun_defi({ path: "chains" })                                               // $0.0060 — where DeFi capital sits
blockrun_markets({ path: "markets/search", params: { q: "bitcoin", status: "open" } })  // $0.0085 — what the crowd is pricing

ETF flows, funding rates, liquidation charts and the Fear & Greed index were Surf features with no BlockRun source today.

6. "Is gold up today?" — also free
ts
blockrun_price({ action: "price", category: "commodity", symbol: "XAU-USD" })   // FREE

© 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/crypto-data of BlockRunAI/blockrun-mcp.

Open the folder on GitHubat commit a7a9b3c

Compare with similar skills

Crypto Data 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.

Crypto Data compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Crypto Data this skillBlockRunAI/blockrun-mcp392—~2.8kAutomated safety check: PassMIT
SurfBlockRunAI/ClawRouter6.6k—~4kAutomated safety check: PassMIT
ZerionBankrBot/skills1.2k—~3.6kAutomated safety check: PassNone
Zerion Wallet Datamoonpay/skills113—~1.7kAutomated safety check: PassMIT
Lonestaroracle DataBankrBot/skills1.2k—~2kAutomated safety check: PassNone
Bridge Stablecoincirclefin/skills155—~3.4kAutomated safety check: NotesApache-2.0

Similar skills

  • 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
  • Zerion

    BankrBot/skills

    Interpreted crypto wallet data for AI agents. An agent skill from BankrBot/skills.

    1.2k GitHub stars~3.6k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Zerion Wallet Data

    moonpay/skills

    A skill your agent uses when the user asks to check a wallet's portfolio, token balances, DeFi positions, PnL, transaction history, or NFTs.

    113 GitHub stars~1.7k tokensUpdated 27 days ago
    Business, Finance & HRAuto-check passed
  • Lonestaroracle Data

    BankrBot/skills

    Live pay-per-call data for crypto and DeFi protocol risk, funding rates, open interest, liquidations, stablecoin health, macro, equities, and on-chain intelligence — settled per query in USDC on…

    1.2k GitHub stars~2k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Bridge Stablecoin

    circlefin/skills

    Build browser or server USDC bridging with Circle App Kit or standalone Bridge Kit and CCTP.

    155 GitHub stars~3.4k tokensUpdated 21 days ago
    Business, Finance & HRAuto-check: notes
  • Pay Via Agent Wallet

    circlefin/skills

    A skill your agent uses when the user wants to call a paid API, look something up online, search for data, get prices, odds, or stats, or use any paid service with automatic USDC payment.

    155 GitHub stars~3.9k tokensUpdated 21 days ago
    Business, Finance & HRAuto-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
  • Decide

    BlockRunAI/blockrun-mcp

    A skill your agent uses when the user wants to try BlockRun's free typed-judgment endpoint (POST api.blockrun.ai/v1/decide, served by OpenJev) on their own data from Claude Code — yes/no, labelled…

    392 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed

Questions about Crypto Data

What does Crypto Data do?

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…. Crypto Data is an agent skill from BlockRunAI/blockrun-mcp. Use 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; also when the user asks for on-chain SQL, wallet labels/net worth, social mindshare or crypto news, so they are told plainly what BlockRun serves and what it does not.

When should I use Crypto Data?

Crypto Data fits situations like: any crypto data question — token/coin prices; DEX pairs and liquidity; yield/APY pools; raw JSON-RPC against a chain.

How do I install Crypto Data in Claude Code?

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

How do I install Crypto Data in Codex?

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

Can I use Crypto Data 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 crypto-data -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/crypto-data, .gemini/skills/crypto-data, .github/skills/crypto-data and .opencode/skills/crypto-data in your project.

What does Crypto Data need to run?

SKILL.md names no scripts, command-line tools or credentials: Crypto Data is instructions for the agent only.

Does Crypto Data access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

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

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

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

Skills that share tags, products or a category with Crypto Data: Surf (BlockRunAI/ClawRouter, 6.6k stars), Zerion (BankrBot/skills, 1.2k stars), Zerion Wallet Data (moonpay/skills, 113 stars) and Lonestaroracle Data (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 Crypto Data?

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.