v1.3.0 to v2.0.0

36 added, 46 removed. Audit A to A.

---

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

+ version: 2.0.0

+ description: Social intelligence and sentiment data - Galaxy Score, AltRank, social volume, influencer activity

+ delivery: script

+ protected: true

metadata:

starchild:

emoji: "🌙"

skillKey: lunarcrush

requires:

env:

- LUNARCRUSH_API_KEY

user-invocable: false

disable-model-invocation: false

---

- # LunarCrush

+ ## Script Usage

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

+ Script-mode skill — read this file, then invoke from a `bash` block:

- ## What LunarCrush Does vs Other Data Sources

+ ```bash

+ python3 - <<'EOF'

+ import sys, json

+ sys.path.insert(0, "/data/workspace/skills/lunarcrush")

+ from exports import lunar_coin, lunar_coin_time_series, lunar_topic

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

+ # BTC social metrics

+ btc = lunar_coin(coin="BTC")

+ print(json.dumps(btc, indent=2))

- LunarCrush = "what's people saying and feeling"

- Others = "what are the numbers"

+ # 30-day BTC galaxy_score timeseries

+ ts = lunar_coin_time_series(coin="BTC", bucket="day", interval="1m")

+ print(json.dumps(ts.get("data", [])[:3], indent=2))

+ EOF

+ ```

+ Available functions in `exports.py`: `lunar_coin`, `lunar_coin_time_series`,

+ `lunar_coin_meta`, `lunar_topic`, `lunar_topic_posts`, `lunar_creator`.

+ Read `exports.py` directly for exact signatures.

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

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

+ - **Social sentiment** - What is the crowd saying?

+ - **Galaxy Score** - Overall social momentum (0-100)

+ - **AltRank** - Social ranking (lower is better)

+ - **Social volume** - Number of social mentions

+ - **Influencer activity** - What are key voices saying?

+ - **Trending topics** - What's gaining attention?

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

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

+ lunar_topic_posts(topic="nft") # Recent posts about NFTs

```

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