LunarCrush

LunarCrush provides social intelligence and sentiment data including Galaxy Score, AltRank, social volume, influencer activity, and trending topics. This is the crowd-mood layer.

What LunarCrush Does vs Other Data Sources

Provider	Data Type	What It's Good At
LunarCrush	Non-structured	News, posts, sentiment, social volume, narrative tracking
CoinGecko	Structured	Prices, market cap, volume, trending coins
CoinGlass	Structured	Funding rates, OI, liquidations, long/short ratios
DefiLlama	Structured	TVL, protocol revenue, yield data, chain flows

LunarCrush = "what's people saying and feeling" Others = "what are the numbers"

When to Use LunarCrush

Use LunarCrush for:

Social sentiment — Galaxy Score, AltRank, social volume
News aggregation — Topic and category level news feeds
Content search — Cross-scope keyword search with sentiment summary
Narrative tracking — What topics/categories are gaining attention
Influencer activity — What key voices are saying

Common Workflows

Coin Social Data

lunar_coin(symbol="BTC")  # Current social metrics
lunar_coin(symbol="ETH")  # Ethereum social data
lunar_coin_time_series(symbol="SOL", interval="1d", bucket="day")  # Historical
lunar_coin_meta(symbol="BTC")  # Metadata and links

Topic & Category Content Analysis

lunar_topic(topic="defi")  # DeFi topic metrics
lunar_topic_posts(topic="nft")  # Social posts about NFTs
lunar_topic_news(topic="bitcoin", limit=10)  # Topic-level news feed
lunar_category_news(category="defi", limit=10)  # Category-level news feed
lunar_category_posts(category="gaming", limit=10)  # Category social posts
lunar_content_feed(feed_type="news", scope_type="topic", scope="solana", limit=20)  # Unified feed
lunar_search_content(query="ETF approval", topics=["bitcoin","ethereum"], limit=30)  # Cross-scope search

Content Search Engine

lunar_search_content(query="halving")                    # Keyword search across defaults
lunar_search_content(query="regulation", time_window="7d")  # Time-filtered
lunar_search_content(topics=["defi"], feed_types=["news","posts"])  # All DeFi content

Creator/Influencer

lunar_creator(creator_id="123456")  # Specific influencer data

Key Metrics

Galaxy Score (0-100)

Score	Read
80–100	Exceptional social momentum — watch for tops
60–79	Strong sustained interest
40–59	Normal activity
20–39	Declining interest
0–19	Dead or bottoming

Divergence signal: High Galaxy Score + negative price = potential reversal.

AltRank

Lower is better. #1–50 is top tier social presence. Useful for finding altcoins gaining attention before price moves.

Rank 1-10: Highest social attention
Rank 11-50: Strong social presence
Rank 51-100: Moderate attention
Rank 100+: Low social attention

Social Volume

Number of social mentions across platforms (Twitter, Reddit, etc.). Rising social volume often precedes price moves.

Social Dominance

Percentage of total crypto social volume. High dominance means the coin is dominating crypto conversations.

Analysis Patterns

Social alpha: Rising Galaxy Score + flat price = potential breakout setup. Social attention building before price moves.

Divergence signals:

High Galaxy Score + falling price = bearish divergence
Low Galaxy Score + rising price = weak rally

Sentiment confirmation: Combine Galaxy Score + social volume + AltRank. All three moving in same direction = strong signal.

Influencer tracking: Monitor what key voices are saying via creator tools. Influencer attention can drive retail interest.

Time Intervals

1h - Hourly
1d - Daily
1w - Weekly

Important Notes

API Key: Requires LUNARCRUSH_API_KEY environment variable
Symbols: Use standard symbols (BTC, ETH, SOL, etc.)
Social platforms: Data aggregated from Twitter, Reddit, Medium, YouTube, and more
Real-time: Social metrics update in near real-time
Leading indicator: Social data often leads price - attention builds before price moves

Workflow Examples

Find Rising Coins

Use lunar_coin to check AltRank and Galaxy Score
Look for coins with rising AltRank (lower number = better) and Galaxy Score > 60
Check if price is flat or rising - social attention building is a leading signal

Sentiment Check

Get current Galaxy Score and social volume
Compare to historical data via lunar_coin_time_series
High score + rising volume = strong momentum
Low score + falling volume = weak interest

Topic Trends

Use lunar_topic to find trending topics (DeFi, NFT, Gaming, etc.)
Use lunar_topic_posts to see what people are saying
Cross-reference with price action for early trend signals

@554/lunarcrush