Get Topic Social Metrics
Retrieve comprehensive social media metrics for cryptocurrency topics including sentiment, mentions, and engagement.
Tool Name: get_topic_metrics
MCP Endpoint: POST /hive_social_sentiment/mcp
Data Source: LunarCrush
Overview
Track social sentiment and engagement for any crypto topic:
- Galaxy Score™: Proprietary score combining social and market metrics
- AltRank™: Relative performance vs other cryptocurrencies
- Sentiment analysis: Bullish/bearish/neutral breakdown
- Engagement metrics: Mentions, interactions, contributors
- 24h comparisons: Changes from previous period
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| topic | string | Yes | Cryptocurrency symbol or topic (e.g., "BTC", "ETH", "DeFi") |
Examples
Get Bitcoin Social Metrics
curl -X POST https://api.hiveintelligence.xyz/api/execute \
-H "Content-Type: application/json" \
-d '{
"toolName": "get_topic_metrics",
"arguments": {
"topic": "BTC"
}
}'
Response:
{
"topic": "BTC",
"name": "Bitcoin",
"galaxy_score": 72,
"alt_rank": 1,
"social_volume": 45678,
"social_volume_24h_change": 12.5,
"social_contributors": 12345,
"social_dominance": 28.5,
"sentiment": {
"bullish": 65,
"bearish": 20,
"neutral": 15
},
"interactions": 234567,
"interactions_24h_change": 8.3
}
Python - Sentiment Dashboard
import requests
def get_social_metrics(topic):
response = requests.post(
"https://api.hiveintelligence.xyz/api/execute",
json={
"toolName": "get_topic_metrics",
"arguments": {"topic": topic}
}
)
return response.json()
# Compare top coins
coins = ["BTC", "ETH", "SOL", "DOGE"]
print("Social Sentiment Dashboard")
print("=" * 50)
for coin in coins:
metrics = get_social_metrics(coin)
sentiment = metrics.get("sentiment", {})
print(f"\n{coin}:")
print(f" Galaxy Score: {metrics.get('galaxy_score', 'N/A')}")
print(f" Sentiment: {sentiment.get('bullish', 0)}% bullish")
print(f" Social Volume: {metrics.get('social_volume', 0):,}")
Metrics Explained
| Metric | Description |
|---|---|
| Galaxy Score | 0-100 score combining social + market factors |
| AltRank | Ranking vs all tracked cryptocurrencies |
| Social Volume | Total mentions across platforms |
| Social Dominance | % of total crypto social conversation |
| Sentiment | AI-analyzed bullish/bearish/neutral split |
Related Tools
- get_topic_posts - Top posts for topic
- get_topic_news - News mentions
- get_trending_topics - Trending topics
- exa_search_social - Social search