lunarcrush v1.3.0A

Immutable. This exact content is served forever at /api/v1/blob/16657589060e6acb.

---
name: lunarcrush
version: 1.3.0
description: Crypto non-structured data expert — social sentiment, news aggregation, content search, influencer tracking, and topic/category intelligence
author: Radar
tags: [crypto, sentiment, news, social, lunarcrush, analytics]
tools:
  - lunar_coin
  - lunar_coin_time_series
  - lunar_coin_meta
  - lunar_topic
  - lunar_topic_posts
  - lunar_topic_news
  - lunar_category_posts
  - lunar_category_news
  - lunar_content_feed
  - lunar_search_content
  - lunar_creator

metadata:
  starchild:
    emoji: "🌙"
    skillKey: lunarcrush
    requires:
      env:
        - LUNARCRUSH_API_KEY

user-invocable: false
disable-model-invocation: false
---

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