surf-social

name	surf-social
description	Crypto-Twitter / KOL intelligence via Surf — project mindshare time series, smart-follower history (high-signal accounts), social ranking, tweet + replies fetch, user profile / followers / posts / replies. Use when the user asks about KOL sentiment, project attention, smart money commentary, narrative momentum, or specific Twitter handles.
triggers	["kol sentiment","mindshare","smart followers","crypto twitter","ct sentiment","twitter analysis","social ranking","tweet","twitter handle"]
argument-hint	<project, handle, or question>
cost-receipt	true

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/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