lunarcrush

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Script Usage

脚本使用方法

Script-mode skill — read this file, then invoke from a

bash

block:

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

脚本模式技能——阅读本文件后，在

bash

代码块中调用：

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

BTC social metrics

BTC社交指标

btc = lunar_coin(coin="BTC") print(json.dumps(btc, indent=2))

30-day BTC galaxy_score timeseries

30天BTC galaxy_score时间序列

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.

ts = lunar_coin_time_series(coin="BTC", bucket="day", interval="1m") print(json.dumps(ts.get("data", [])[:3], indent=2)) EOF


`exports.py`中的可用函数：`lunar_coin`、`lunar_coin_time_series`、`lunar_coin_meta`、`lunar_topic`、`lunar_topic_posts`、`lunar_creator`。如需了解确切签名，请直接查看`exports.py`文件。

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.

LunarCrush提供社交情报与情绪数据，包括Galaxy Score、AltRank、社交提及量、网红活跃度及热门话题，是用于捕捉大众情绪的工具层。

Function Reference (signatures)

函数参考（签名）

All functions are in

exports.py

. Coin symbols are uppercase (

BTC

ETH

SOL

Function	Description
`lunar_coin(coin)`	Current social metrics: `galaxy_score` , `alt_rank` , `social_volume` , `social_dominance` , price, market_cap. Returns dict (not wrapped in `{data: ...}` ).
`lunar_coin_time_series(coin, bucket='day', interval='1m')`	Historical timeseries. `bucket` = `hour` / `day` / `week` . `interval` = `1d` / `1w` / `1m` / `3m` / `6m` / `1y` .
`lunar_coin_meta(coin)`	Coin metadata (description, links, categories).
`lunar_topic(topic)`	Social metrics for a topic/keyword (e.g. `bitcoin` , `defi` ).
`lunar_topic_posts(topic, limit=20)`	Recent posts mentioning the topic, sorted by engagement.
`lunar_creator(network, id)`	Creator/influencer data. `network` = `twitter` / `youtube` / `reddit` / `tiktok` . `id` = handle without `@` .

所有函数均位于

exports.py

中。加密货币符号需使用大写形式（

BTC

、

ETH

、

SOL

）。

函数	描述
`lunar_coin(coin)`	当前社交指标： `galaxy_score` 、 `alt_rank` 、 `social_volume` 、 `social_dominance` 、价格、市值。返回字典格式（不包含在 `{data: ...}` 中）。
`lunar_coin_time_series(coin, bucket='day', interval='1m')`	历史时间序列数据。 `bucket` 可选值： `hour` / `day` / `week` 。 `interval` 可选值： `1d` / `1w` / `1m` / `3m` / `6m` / `1y` 。
`lunar_coin_meta(coin)`	加密货币元数据（描述、链接、分类）。
`lunar_topic(topic)`	特定话题/关键词的社交指标（例如 `bitcoin` 、 `defi` ）。
`lunar_topic_posts(topic, limit=20)`	提及该话题的近期帖子，按互动量排序。
`lunar_creator(network, id)`	创作者/网红数据。 `network` 可选值： `twitter` / `youtube` / `reddit` / `tiktok` 。 `id` 为不带 `@` 的账号名。

When to Use LunarCrush

何时使用LunarCrush

Use LunarCrush for:

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?

LunarCrush适用于以下场景：

社交情绪分析 - 大众对加密货币的看法如何？
Galaxy Score - 整体社交热度（0-100分）
AltRank - 社交排名（数值越低排名越高）
社交提及量 - 社交平台上的提及次数
网红活跃度 - 关键意见领袖的动态
热门话题追踪 - 哪些话题正在获得关注？

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

lunar_coin(symbol="BTC")  # 获取当前社交指标
lunar_coin(symbol="ETH")  # 获取以太坊社交数据
lunar_coin_time_series(symbol="SOL", interval="1d", bucket="day")  # 获取历史时间序列数据
lunar_coin_meta(symbol="BTC")  # 获取元数据及相关链接

Topic Analysis

话题分析

lunar_topic(topic="defi")  # DeFi topic metrics
lunar_topic_posts(topic="nft")  # Recent posts about NFTs

lunar_topic(topic="defi")  # 获取DeFi话题指标
lunar_topic_posts(topic="nft")  # 获取关于NFT的近期帖子

Creator/Influencer

创作者/网红追踪

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

lunar_creator(creator_id="123456")  # 获取特定网红的数据

Key Metrics

核心指标

Galaxy Score (0-100)

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.

分数区间	解读
80–100	社交势头极佳——警惕顶部出现
60–79	持续高关注度
40–59	正常活跃度
20–39	关注度下降
0–19	活跃度极低或触底

背离信号：高Galaxy Score + 价格下跌 = 潜在反转。

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

数值越低排名越高。1–50名属于社交热度第一梯队，可用于发现价格上涨前已获得关注的另类币。

1-10名：社交关注度最高
11-50名：社交热度较高
51-100名：中等关注度
100名以外：低关注度

Social Volume

社交提及量

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

各社交平台（Twitter、Reddit等）上的提及总数。社交提及量上升通常先于价格变动。

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.

社交alpha信号：Galaxy Score上升 + 价格平稳 = 潜在突破信号，社交关注度正在积累，尚未反映在价格上。

背离信号:

高Galaxy Score + 价格下跌 = 看跌背离
低Galaxy Score + 价格上涨 = 弱势反弹

情绪确认：结合Galaxy Score + 社交提及量 + AltRank，三者同向变动时信号强度高。

网红追踪：通过创作者工具监控关键意见领袖的动态，网红关注度可带动散户兴趣。

Time Intervals

时间间隔

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

```
1h
```
- 小时级
```
1d
```
- 日级
```
1w
```
- 周级

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

API密钥：需要设置LUNARCRUSH_API_KEY环境变量
币种符号：使用标准符号（BTC、ETH、SOL等）
社交平台：数据聚合自Twitter、Reddit、Medium、YouTube等多个平台
实时性：社交指标近乎实时更新
领先指标：社交数据通常领先于价格变动——关注度积累先于价格上涨

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

使用
```
lunar_coin
```
查看AltRank和Galaxy Score
寻找AltRank上升（数值越低越好）且Galaxy Score > 60的币种
检查价格是否平稳或上涨——社交关注度积累是领先信号

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

获取当前Galaxy Score和社交提及量
通过
```
lunar_coin_time_series
```
对比历史数据
高分 + 提及量上升 = 强劲势头
低分 + 提及量下降 = 关注度疲软

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

使用
```
lunar_topic
```
查找热门话题（DeFi、NFT、GameFi等）
使用
```
lunar_topic_posts
```
查看用户讨论内容
结合价格走势获取早期趋势信号