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.
Reads public blockchain data (active addresses, whale activity, TVL, DEX liquidity) and valuation metrics such as MVRV, NVT and SOPR to interpret conditions and generate signals.
$ npx skills add HKUDS/Vibe-Trading --skill onchain-analysis -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install HKUDS/Vibe-Trading onchain-analysis --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent/src/skills/onchain-analysis .claude/skills/onchain-analysis && rm -rf skills-srcUse ~/.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/
Install the "onchain-analysis" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/onchain-analysis into .claude/skills/onchain-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onchain-analysis", 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 install https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/onchain-analysisType 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.
$ npx skills add HKUDS/Vibe-Trading --skill onchain-analysis -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install HKUDS/Vibe-Trading onchain-analysis --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .agents/skills && cp -r skills-src/agent/src/skills/onchain-analysis .agents/skills/onchain-analysis && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "onchain-analysis" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/onchain-analysis into .agents/skills/onchain-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onchain-analysis", 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.
$ npx skills add HKUDS/Vibe-Trading --skill onchain-analysis -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install HKUDS/Vibe-Trading onchain-analysis --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/agent/src/skills/onchain-analysis .cursor/skills/onchain-analysis && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "onchain-analysis" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/onchain-analysis into .cursor/skills/onchain-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onchain-analysis", 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 https://github.com/HKUDS/Vibe-Trading.git --path agent/src/skills/onchain-analysis--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add HKUDS/Vibe-Trading --skill onchain-analysis -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install HKUDS/Vibe-Trading onchain-analysis --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/agent/src/skills/onchain-analysis .gemini/skills/onchain-analysis && rm -rf skills-srcUse ~/.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/
Install the "onchain-analysis" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/onchain-analysis into .gemini/skills/onchain-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onchain-analysis", 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.
$ gh skill install HKUDS/Vibe-Trading onchain-analysisInstalls 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).
$ npx skills add HKUDS/Vibe-Trading --skill onchain-analysis -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .github/skills && cp -r skills-src/agent/src/skills/onchain-analysis .github/skills/onchain-analysis && rm -rf skills-srcUse ~/.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/
Install the "onchain-analysis" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/onchain-analysis into .github/skills/onchain-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onchain-analysis", 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.
$ npx skills add HKUDS/Vibe-Trading --skill onchain-analysis -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install HKUDS/Vibe-Trading onchain-analysis --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/agent/src/skills/onchain-analysis .opencode/skills/onchain-analysis && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "onchain-analysis" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/onchain-analysis into .opencode/skills/onchain-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onchain-analysis", 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.
onchain-analysisReads public blockchain data (active addresses, whale activity, TVL, DEX liquidity) and valuation metrics such as MVRV, NVT and SOPR to interpret conditions and generate signals.
The skill uses transparent blockchain data for crypto analysis in four areas: network activity, whale behavior, DeFi liquidity and on-chain valuation. A metrics table covers active addresses, new addresses, transaction count, transfer value and an activity-to-price ratio, each with a bullish and a bearish reading, and a short framework contrasts a bull market driven by real demand with one where price rises without matching activity.
Whale tracking defines holder tiers for BTC and ETH, lists behavior signals such as withdrawals from exchanges and a rising count of whale wallets, and sets large transfer thresholds to watch. A historical table gives reference ranges for BTC active addresses across market phases, and the stated scope also includes TVL, DEX liquidity and the MVRV, NVT and SOPR valuation metrics.
7 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit e532650. It shows what the files ask for, not the result of running them.
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.
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
On-Chain Data Analysis loads about 2.5k tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 468 words of instructions outside code blocks.
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.
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.
The full file from HKUDS/Vibe-Trading at commit e532650, republished under its MIT licence (© HKUDS). 468 words, ~2,452 tokens.
.claude/skills/onchain-analysis/SKILL.md (or your agent's skills folder).Use transparent public blockchain data for analysis, covering network activity, whale-behavior tracking, DeFi liquidity analysis, and on-chain valuation metrics. This provides crypto investing with data dimensions unavailable in traditional finance.
| Metric | Meaning | Bullish Signal | Bearish Signal |
|---|---|---|---|
| Active addresses | Unique addresses interacting with the network each day | Sustained increase (network adoption rising) | Sustained decline |
| New addresses | Addresses appearing for the first time each day | Accelerating growth (new users entering) | Shrinkage |
| Transaction count | Number of on-chain transactions per day | Steady growth | Sharp decline |
| Transfer value | Total value transferred on-chain per day | Large-value transfer activity | Inactive |
| Activity / price ratio | Growth in active addresses vs growth in price | Activity growth outpaces price growth | Price rises but activity does not |
Healthy bull market:
Price↑ + active addresses↑ + new addresses↑ = driven by real demand
Bubble signal:
Price↑ + active addresses↓ or flat = capital-driven, not user-driven
Bottoming signal:
Price↓ + active addresses bottom out and stabilize = speculators exit, real users remain| Phase | Active Addresses (daily avg) | BTC Price | Meaning |
|---|---|---|---|
| 2020 bear-to-bull transition | 0.8-1.0 million | $10k-$20k | Bottom stabilization |
| 2021 bull market | 1.0-1.3 million | $30k-$69k | Healthy growth |
| 2022 bear market | 0.8-0.9 million | $16k-$30k | Pulled back but did not collapse |
| 2024 bull market | 0.9-1.2 million | $40k-$100k | Institution-driven |
| Tier | BTC Holdings | ETH Holdings | Estimated Count |
|---|---|---|---|
| Super whales | >10,000 BTC | >100,000 ETH | ~100 |
| Large whales | 1,000-10,000 BTC | 10,000-100,000 ETH | ~2,000 |
| Mid whales | 100-1,000 BTC | 1,000-10,000 ETH | ~15,000 |
| Small whales | 10-100 BTC | 100-1,000 ETH | ~150,000 |
Bullish signals:
1. Whales withdraw from exchanges -> intent to hold long term
2. Whale-wallet count rises -> institutions / large holders accumulating
3. Exchange BTC balance keeps falling -> lower available supply
4. Long-term holder (LTH) balances rise -> smart money buying
Bearish signals:
1. Large whale transfers into exchanges -> preparing to sell
2. Dormant addresses wake up and transfer -> early holders taking profits
3. Exchange balances surge -> sell pressure is about to be released
4. Miner balances fall and move to exchanges -> miner capitulation / profit takingThresholds to watch:
- BTC: single transfer > 500 BTC (about $50M)
- ETH: single transfer > 10,000 ETH (about $30M)
- USDT: single transfer > $50M
Transfer-direction analysis:
- Wallet -> exchange: potential selling (bearish)
- Exchange -> wallet: withdrawal to hold (bullish)
- Exchange -> exchange: arbitrage transfer (neutral)
- Wallet -> wallet: OTC trade (watch follow-up behavior)TVL = total value of assets locked in DeFi protocols
TVL analysis dimensions:
1. Total TVL trend: rising = capital flowing into the DeFi ecosystem
2. Cross-chain TVL: market-share changes among ETH vs Solana vs Arbitrum
3. Protocol TVL ranking: leading protocols such as Aave / Lido / Maker
4. TVL / market cap ratio: similar to asset-utilization rate in traditional finance| Metric | Meaning | Focus |
|---|---|---|
| DEX volume | Daily decentralized-exchange volume | Trend in DEX / CEX ratio |
| Liquidity depth | Size of AMM liquidity pools | Bigger pools = lower slippage = better |
| LP yield | Annualized return for liquidity providers | Abnormally high = unsustainable |
| Impermanent loss | Opportunity cost for LPs | More severe when volatility is higher |
Stablecoin inflows = "dry powder" for the crypto market
Metrics to watch:
1. Changes in total USDT / USDC supply
2. Stablecoin balances on exchanges
3. Stablecoin mint / burn activity (Tether / Circle)
4. Stablecoin market-cap share (lower = higher risk appetite)
Signals:
- Heavy stablecoin minting -> capital preparing to enter
- Exchange stablecoin balances up -> buying power is accumulating
- Stablecoin share rising quickly -> risk-off market (capital rotating from coins into stablecoins)MVRV = market cap / realized cap
Realized cap = Σ(each UTXO × price at last movement)
= sum of all holders' cost basis
| MVRV | Meaning | Historical Signal |
|------|------|---------|
| > 3.5 | Severely overvalued, large unrealized profits across holders | Historical top zone |
| 2.0-3.5 | Richly valued, most holders in profit | Mid-to-late bull market |
| 1.0-2.0 | Reasonable range | Normal market or early bull market |
| < 1.0 | Undervalued, most holders underwater | Bear-market bottom zone |
Signal logic: MVRV > 3.5 -> most holders have large unrealized gains -> strong incentive to sell -> potential top
MVRV < 1.0 -> most holders are losing money -> unwilling to sell -> potential bottomNVT = market cap / daily on-chain transfer value
Similar to a PE ratio in traditional finance:
- High NVT: market cap is high relative to on-chain activity (overvalued or optimistic on future growth)
- Low NVT: market cap is low relative to on-chain activity (undervalued or value-like)
NVT Signal (improved):
NVT_Signal = market cap / MA(90, daily on-chain transfer value)
Use a 90-day moving average to smooth noise
| NVT Signal | Meaning |
|-----------|------|
| > 150 | Severely overvalued |
| 65-150 | Normal range |
| < 65 | Undervalued |SOPR = realized value of spent outputs / creation value of spent outputs
Simply put: on average, are the coins sold today being sold at a profit or a loss?
| SOPR | Meaning | Signal |
|------|------|------|
| > 1.05 | Sellers are realizing 5%+ profit on average | Profit-taking pressure |
| 1.0-1.05 | Small-profit selling | Normal |
| = 1.0 | Break-even | Key support / resistance |
| < 1.0 | Selling at a loss | Panic selling (bottom signal) |
In bull markets: a pullback to SOPR = 1.0 is a buy opportunity (cost-basis support)
In bear markets: a rebound to SOPR = 1.0 is a sell opportunity (cost-basis resistance)| Metric | Formula | Purpose |
|---|---|---|
| Puell Multiple | Daily miner revenue / MA(365, daily miner revenue) | Miner-income cycle |
| Stock-to-Flow | stock / annual production | BTC scarcity model |
| Reserve Risk | HODL Bank / price | Holder confidence |
| Exchange balance | total BTC held on exchanges | Supply-side pressure |
Score each indicator from 1 to 5 and combine with weights:
| Dimension | Weight | Indicators |
|------|------|------|
| Valuation | 30% | MVRV, NVT |
| Activity | 25% | active addresses, new addresses |
| Capital flow | 25% | exchange balances, stablecoins |
| Whale behavior | 20% | whale holdings, large transfers |
Total score > 4.0: strongly bullish
Total score 3.0-4.0: bullish bias
Total score 2.0-3.0: neutral
Total score < 2.0: bearish / leaning bearish## On-Chain Analysis Report: BTC
### On-Chain Snapshot
| Metric | Current Value | Historical Percentile | Signal |
|------|--------|---------|------|
| MVRV | 2.1 | 65% | Elevated but not at a top |
| NVT Signal | 85 | 50% | Fair |
| SOPR(7d avg) | 1.02 | 55% | Slight profit-taking state |
| Active addresses | 950k/day | 45% | Relatively low |
| Exchange balance | 2.30M BTC | 30% | Low level (bullish) |
### Whale Activity
- Last 7 days: net withdrawal of +15,000 BTC (bullish)
- Large transfers: 3 transfers >1000 BTC into cold wallets
- Miners: holdings stable, no major outflows observed
### Composite Score: 3.5/5 (bullish bias)
### Conclusion
On-chain data is broadly bullish. MVRV is not yet in an extreme zone, exchange balances are low,
and whales continue to accumulate. But active addresses remain soft, so monitor whether this is an
"institution-driven bull market without retail participation". Maintain long exposure, but keep
position sizing controlled and avoid leverage.© HKUDS, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in agent/src/skills/onchain-analysis of HKUDS/Vibe-Trading.
Open the folder on GitHubat commit e532650
On-Chain Data Analysis 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| On-Chain Data Analysis this skillHKUDS/Vibe-Trading | 35k | — | ~2.5k | Automated safety check: Pass | MIT | |
| Surf Crypto Data APIBlockRunAI/blockrun-mcp | 391 | — | ~1.7k | Automated safety check: Pass | MIT | |
| Web3 Data Explorerinternet-court/internet-court-skill | 6.5k | 1 repos | ~2k | Automated safety check: Pass | MIT | |
| Technical Analysttradermonty/claude-trading-skills | 3k | 4 repos | ~4.6k | Automated safety check: Pass | MIT | |
| Predexon Prediction Market DataBlockRunAI/ClawRouter | 6.6k | — | ~4.7k | Automated safety check: Pass | MIT | |
| Virtuals Protocol AcpVirtual-Protocol/openclaw-acp | 168 | 1 repos | ~6.4k | Automated safety check: Pass | None |
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.
internet-court/internet-court-skill
Queries on-chain data with the Chainbase CLI and tracks crypto social trends: token holders and prices, wallet balances, ENS names, narratives and KOL signals.
tradermonty/claude-trading-skills
This skill should be used when analyzing weekly price charts for stocks, stock indices, cryptocurrencies, or forex pairs.
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.
Virtual-Protocol/openclaw-acp
Hire specialised agents to handle any task — data analysis, trading, content generation, research, on-chain operations, 3D printing, physical goods, gift delivery, and more.
zj-unicom-ai/UniEmployee
Produces a full business health analysis from sales, finance, inventory and customer CSV files: core KPIs, monthly trends, drill-downs and recommendations.
HKUDS/Vibe-Trading
Index of Eastmoney's free, no-token market data interfaces for China A-shares and Hong Kong stocks: fund flows, dragon-tiger lists, margin trading, reports and news.
HKUDS/Vibe-Trading
Retrieves public OKX cryptocurrency market data such as spot prices, candlesticks, funding rates and open interest through the OKX V5 REST API, with no authentication.
HKUDS/Vibe-Trading
Fetches U.S. SEC EDGAR data: resolves tickers to CIK numbers, lists recent 10-K, 10-Q and 8-K filings with document URLs, and pulls XBRL financial series.
HKUDS/Vibe-Trading
Predicts whether a mainland China A-share company risks an ST or *ST warning after its next annual report, using financial thresholds and Sina penalty records.
HKUDS/Vibe-Trading
Breaks a structural trend such as AI infrastructure into its physical supply chain and ranks lesser-known listed companies sitting on each bottleneck.
HKUDS/Vibe-Trading
Plans and drafts an eight-part, roughly 120k-word investigative series on one company, built around a strict fact-check pass rather than fast drafting.
Categories
Reads public blockchain data (active addresses, whale activity, TVL, DEX liquidity) and valuation metrics such as MVRV, NVT and SOPR to interpret conditions and generate signals. The skill uses transparent blockchain data for crypto analysis in four areas: network activity, whale behavior, DeFi liquidity and on-chain valuation. A metrics table covers active addresses, new addresses, transaction count, transfer value and an activity-to-price ratio, each with a bullish and a bearish reading, and a short framework contrasts a bull market driven by real demand with one where price rises without matching activity.
On-Chain Data Analysis fits situations like: judging whether a rally is backed by growing network activity; tracking whale wallets and large exchange withdrawals; reading MVRV, NVT or SOPR as valuation signals; assessing DEX liquidity and TVL for a protocol.
Run `npx skills add HKUDS/Vibe-Trading --skill onchain-analysis -a claude-code`. Or copy the skill folder (agent/src/skills/onchain-analysis in HKUDS/Vibe-Trading) into .claude/skills/onchain-analysis in your project. Claude Code loads it when a task matches its description.
Run `npx skills add HKUDS/Vibe-Trading --skill onchain-analysis -a codex`. Or copy the skill folder (agent/src/skills/onchain-analysis in HKUDS/Vibe-Trading) into .agents/skills/onchain-analysis in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HKUDS/Vibe-Trading --skill onchain-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/onchain-analysis, .gemini/skills/onchain-analysis, .github/skills/onchain-analysis and .opencode/skills/onchain-analysis in your project.
SKILL.md names no scripts, command-line tools or credentials: On-Chain Data Analysis is instructions for the agent only.
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.
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.
On-Chain Data Analysis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.5k tokens (SKILL.md is roughly 9.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with On-Chain Data Analysis: Surf Crypto Data API (BlockRunAI/blockrun-mcp, 391 stars), Web3 Data Explorer (internet-court/internet-court-skill, 6.5k stars), Technical Analyst (tradermonty/claude-trading-skills, 3k stars) and Predexon Prediction Market Data (BlockRunAI/ClawRouter, 6.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
HKUDS (a GitHub organization) maintains it in HKUDS/Vibe-Trading, which has 35,043 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 8, 2026.
Source: HKUDS/Vibe-Trading on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.