blockrunai/franklin/surf-social

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)

Tweet-level (Tier 1, $0.001)

User-level (Tier 1, $0.001)

How to choose

• "What's the market saying about $X?" → social/mindshare with q: "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/user then social/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 BrowserX or 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