BlockRunAI You are running inside Franklin on {{wallet_chain}}. Use the BlockRun tool to call Surf's social endpoints. This is the canonical source for crypto-Twitter signal — mindshare scoring, KOL identification, and reply-graph analysis.
Chain note: Surf currently settles x402 payments on Base only. If the user's active chain is solana and you hit a payment error, ask them to /chain base before retrying. The social data itself is chain-agnostic.
How to use
BlockRun({ path: "/v1/surf/<endpoint>", method: "GET", params: { ... } }). All endpoints below are GET.
Endpoint catalog
Project-level signal (Tier 2, $0.005)
| Path | Required params | What it returns |
|---|---|---|
/v1/surf/social/detail |
— | Aggregated social analytics for a project |
/v1/surf/social/ranking |
— | Mindshare ranking across projects |
/v1/surf/social/smart-followers/history |
— | Smart-follower count history (high-signal accounts only) |
/v1/surf/social/mindshare |
q, interval |
Mindshare time series for a project (q = ticker or name, interval = 1d / 7d / 30d) |
Tweet-level (Tier 1, $0.001)
| Path | Required params | What it returns |
|---|---|---|
/v1/surf/social/tweets |
ids (comma-sep) |
Fetch tweets by ID |
/v1/surf/social/tweet/replies |
tweet_id |
Replies to a specific tweet |
User-level (Tier 1, $0.001)
| Path | Required params | What it returns |
|---|---|---|
/v1/surf/social/user |
handle |
Twitter user profile |
/v1/surf/social/user/followers |
handle |
Followers list |
/v1/surf/social/user/following |
handle |
Following list |
/v1/surf/social/user/posts |
handle |
User posts |
/v1/surf/social/user/replies |
handle |
User replies |
How to choose
- "What's the market saying about $X?" →
social/mindsharewithq: "X", interval: "7d"($0.005). Read the trend, not the absolute number. - "Who's the smart money following $X?" →
social/smart-followers/history($0.005). Compare growth rate to baseline. - "Top projects by attention right now" →
social/ranking($0.005). - "Is @handle a real player?" →
social/userthensocial/user/followers(look at follower-to-following ratio + which smart accounts follow them). - "What did @handle say recently?" →
social/user/posts($0.001 each). - "Show me the reply storm under tweet X" →
social/tweet/replies($0.001).
When NOT to use this skill
- Generic Twitter scraping or non-crypto sentiment → use
BrowserXor a web search tool. Surf is curated for crypto-relevant accounts. - Real-time tweet streaming → not supported; this is historical / batch reads.
Cost discipline
- User-level reads are cheap ($0.001). Free to fan out across 5–10 handles when profiling.
- Project-level signal is $0.005/call. One mindshare + one smart-followers call is usually enough to answer "is this thing real?".
- Always include the cost in your summary.
The user asked
$ARGUMENTS