social-signals

Social Signals

Analyze cryptocurrency social signals from Twitter/X, news sources, and KOL (Key Opinion Leader) discussions.

Data Sources

• Elfa: Trending tokens from web3 KOLs on X/Twitter
• TokenAnalysis: Comprehensive token analysis with social metrics
• SerpAPI: Google News search for crypto topics
• Twitter: Direct tweet search and user timelines

Commands

Get Trending Tokens

python3 {baseDir}/scripts/signals.py trending

Get tokens currently trending among crypto KOLs.

Token Sentiment

python3 {baseDir}/scripts/signals.py sentiment "<token>"

Get social sentiment analysis for a specific token (e.g., BTC, ETH, SOL).

Search News

python3 {baseDir}/scripts/signals.py news "<query>"

Search recent crypto news for a topic.

Event Summary

python3 {baseDir}/scripts/signals.py events "<keyword>"

Get event summary from social mentions for a keyword.

Full Analysis

python3 {baseDir}/scripts/signals.py analyze "<token>"

Comprehensive analysis combining price, social, and news signals.

Output Format

Results include:

• Token symbol and current metrics
• Sentiment score (-1 to 1) and label (bullish/bearish/neutral)
• Mention counts and social volume
• Key discussion topics
• Recent news headlines

Requirements

• UNIFAI_AGENT_API_KEY - UnifAI SDK key for social signal tools
• GOOGLE_API_KEY - Gemini API key for analysis

Example Usage

User: "What's the social sentiment on Solana?"

Assistant: I'll analyze the social signals for SOL.

python3 {baseDir}/scripts/signals.py sentiment "SOL"

User: "What tokens are KOLs talking about?"

Assistant: Let me check what's trending among crypto KOLs.

python3 {baseDir}/scripts/signals.py trending

Signal Types

Signal	Source	Description
Sentiment	TokenAnalysis	Overall social sentiment score
Trending	Elfa	KOL-driven trending tokens
News	SerpAPI	Recent news articles
Mentions	Twitter	Tweet volume and engagement

Notes

• Social signals are lagging indicators - use with caution
• KOL sentiment can shift rapidly
• News sentiment may not reflect market direction
• Best used in combination with market data