blockrunai/franklin/surf-market
- community
Checking that the SKILL.md file is still in the repository.
Crypto market data via Surf — prices, futures, ETFs, options, fear/greed, technical and on-chain indicators, token DEX flows, news, project profiles, VC fund holdings. Use when the user asks about market conditions, ranking tokens, futures positioning, technical signals, options skew, news context, or VC/fund intelligence.
Install
npx vskill@latest install blockrunai/franklin/surf-marketSKILL.md
You are running inside Franklin on {{wallet_chain}}. Crypto market data lives behind the BlockRun tool, which signs USDC x402 payments from the user's wallet on every call. Pick the cheapest endpoint that answers the question.
Chain note: Surf currently settles x402 payments on Base only (treasury is 0x058a59… on Base). If the user's active chain is solana and you hit a payment error, tell them to switch with /chain base before retrying — the request itself works, the wallet just needs to be on Base to sign the payment.
How to use
Call BlockRun({ path: "/v1/surf/<endpoint>", method: "GET", params: { ... } }). All endpoints below are GET unless noted. Required params must be supplied or you'll get a 400 (no charge).
Endpoint catalog
Exchange (CEX intelligence)
| Path | Tier | Required params | What it returns | |
|---|---|---|---|---|
/v1/surf/exchange/markets | $0.001 | — | Trading pairs catalog across major CEXes | |
/v1/surf/exchange/price | $0.001 | pair | Ticker price for a pair | |
/v1/surf/exchange/perp | $0.001 | pair | Perpetual contract snapshot | |
/v1/surf/exchange/depth | $0.005 | pair | Order book depth | |
/v1/surf/exchange/klines | $0.005 | pair | OHLCV candlesticks | |
/v1/surf/exchange/funding-history | $0.005 | pair | Perp funding rate history | |
/v1/surf/exchange/long-short-ratio | $0.005 | pair | Long/short positioning |
Market (broad-market intelligence)
| Path | Tier | Required params | What it returns | |
|---|---|---|---|---|
/v1/surf/market/ranking | $0.001 | — | Token ranking (market cap, volume, change) | |
/v1/surf/market/fear-greed | $0.001 | — | Fear & Greed index history | |
/v1/surf/market/futures | $0.001 | — | Futures market overview | |
/v1/surf/market/price | $0.001 | symbol | Token price history | |
/v1/surf/market/etf | $0.001 | symbol | Spot ETF flow history (BTC, ETH) | |
/v1/surf/market/options | $0.001 | symbol | Options skew / IV / volume | |
/v1/surf/market/liquidation/exchange-list | $0.005 | — | Liquidations by exchange | |
/v1/surf/market/liquidation/order | $0.005 | — | Large liquidation orders | |
/v1/surf/market/liquidation/chart | $0.005 | symbol | Liquidation chart over time | |
/v1/surf/market/onchain-indicator | $0.005 | symbol, metric | NUPL, SOPR, MVRV, Puell, NVT | |
/v1/surf/market/price-indicator | $0.005 | indicator, symbol | RSI, MACD, Bollinger, EMA |
News
| Path | Tier | Required params | What it returns | |
|---|---|---|---|---|
/v1/surf/news/feed | $0.001 | — | AI-curated crypto news feed | |
/v1/surf/news/detail | $0.001 | id | Full article by ID |
Project (DeFi protocols + project profiles)
| Path | Tier | Required params | What it returns | |
|---|---|---|---|---|
/v1/surf/project/detail | $0.001 | — | Aggregated project profile (token + DeFi + social) | |
/v1/surf/project/defi/metrics | $0.001 | metric | Per-protocol DeFi metrics (TVL, fees, revenue) | |
/v1/surf/project/defi/ranking | $0.001 | metric | DeFi protocol ranking |
Token (on-chain analytics)
| Path | Tier | Required params | What it returns | |
|---|---|---|---|---|
/v1/surf/token/tokenomics | $0.001 | — | Unlock schedule + vesting | |
/v1/surf/token/dex-trades | $0.005 | address | DEX trade history |
Fund (VC + treasury intelligence)
| Path | Tier | Required params | What it returns | |
|---|---|---|---|---|
/v1/surf/fund/detail | $0.001 | — | VC fund profile | |
/v1/surf/fund/portfolio | $0.001 | — | VC fund portfolio holdings | |
/v1/surf/fund/ranking | $0.001 | metric | Top VC funds ranking |
How to choose
- "How's the market?" →
market/fear-greed+market/ranking(both $0.001). Cheap snapshot. - "What's BTC doing?" →
market/pricefor history,exchange/pricefor spot tick,market/etffor institutional flow. - "Show me liquidations." →
market/liquidation/chartfor time series,market/liquidation/orderfor whale events. - "Technical signal on ETH" →
market/price-indicatorwithindicator: "RSI"(or MACD, BBANDS, EMA). - "On-chain health" →
market/onchain-indicatorwithmetric: "NUPL"etc. - "Who holds this token / where is it traded?" →
token/tokenomicsfor supply schedule,token/dex-tradesfor flow. - "What VCs back this project?" →
fund/portfolio(filter by project).
Cost discipline
- Most read endpoints are Tier 1 ($0.001). Burn freely.
- Tier 2 ($0.005) endpoints carry depth, history, or fraud-signal data — use when the cheaper endpoint can't answer.
- Avoid speculative multi-endpoint scans. Pick the right endpoint for the question; if unsure, ask the user one clarifying question first.
- Report the cost on every call in your summary: "Pulled fear/greed history ($0.001). Index sits at 62 (greed)."
The user asked
$ARGUMENTS
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingsrc/skills-bundled/surf-market/SKILL.md
Popularity
- 7-day trend score
- 5
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/blockrunai/franklin/surf-market)