@554/lunarcrush

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

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)

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

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

Sentiment Check

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

Topic Trends

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