Hive Intelligence

Tools Reference

Social Sentiment Tools

Social Sentiment Tools

17 tools for social media analytics, creator tracking, and trending topic data.

MCP Endpoint: POST /hive_social_sentiment/mcp

Data Source: LunarCrush


Topic Analytics

get_topic_creators

Get the top creators for a social topic.

ParameterTypeRequiredDescription
topicstringYesCryptocurrency symbol or topic (e.g., "BTC", "ETH")

Example:

curl -X POST https://api.hiveintelligence.xyz/api/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "get_topic_creators",
    "arguments": {
      "topic": "BTC"
    }
  }'

get_topic_news

Get the top news posts for a social topic. Top news is determined by metrics related to social posts that mention the news.

ParameterTypeRequiredDescription
topicstringYesCryptocurrency symbol or topic (e.g., "BTC", "ETH")

get_topic_posts

Get the top posts for a social topic. Returns top posts by interactions from the last 24 hours, or for a specified time range.

ParameterTypeRequiredDescription
topicstringYesCryptocurrency symbol or topic
startstringNoStart timestamp (Unix seconds)
endstringNoEnd timestamp (Unix seconds)

Example:

curl -X POST https://api.hiveintelligence.xyz/api/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "get_topic_posts",
    "arguments": {
      "topic": "ETH"
    }
  }'

get_topic_metrics

Get summary information for a social topic. Returns 24-hour aggregated social activity with metrics comparing to the previous 24 hours.

ParameterTypeRequiredDescription
topicstringYesCryptocurrency symbol or topic

Response includes:

  • Social mentions and interactions
  • Contributor counts
  • Sentiment indicators
  • 24h change comparisons

Get a list of trending social topics across all of crypto.

ParameterTypeRequiredDescription
(none)--No parameters required

Category Analytics

get_category_info

Get summary information for a social category.

ParameterTypeRequiredDescription
categorystringYesCategory name (e.g., "DeFi", "NFT", "Layer1")

Example:

curl -X POST https://api.hiveintelligence.xyz/api/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "get_category_info",
    "arguments": {
      "category": "DeFi"
    }
  }'

get_category_topics

Get the top topics for a social category.

ParameterTypeRequiredDescription
categorystringYesCategory name

get_category_posts

Get the top posts for a social category. Returns top posts by interactions from the last 24 hours, or for a specified time range.

ParameterTypeRequiredDescription
categorystringYesCategory name
startstringNoStart timestamp (Unix seconds)
endstringNoEnd timestamp (Unix seconds)

get_category_news

Get the top news posts for a category. Top news is determined by metrics related to social posts that mention the news.

ParameterTypeRequiredDescription
categorystringYesCategory name

get_category_creators

Get the top creators for a social category.

ParameterTypeRequiredDescription
categorystringYesCategory name

get_categories_list

Get a list of trending social categories.

ParameterTypeRequiredDescription
(none)--No parameters required

Creator Analytics

get_creators_list

Get a list of trending social creators based on interactions across all of social.

ParameterTypeRequiredDescription
(none)--No parameters required

get_creator_profile

Get detailed information on a specific creator.

ParameterTypeRequiredDescription
networkstringYesSocial network (e.g., "twitter", "youtube")
idstringYesCreator ID on the network

Example:

curl -X POST https://api.hiveintelligence.xyz/api/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "get_creator_profile",
    "arguments": {
      "network": "twitter",
      "id": "VitalikButerin"
    }
  }'

get_creator_metrics

Get time series data on a creator's social metrics.

ParameterTypeRequiredDescription
networkstringYesSocial network
idstringYesCreator ID
bucketstringNoTime bucket for aggregation
intervalstringNoTime interval
startstringNoStart timestamp (Unix seconds)
endstringNoEnd timestamp (Unix seconds)

get_creator_posts

Get the top posts for a specific creator.

ParameterTypeRequiredDescription
networkstringYesSocial network
idstringYesCreator ID
startstringNoStart timestamp (Unix seconds)
endstringNoEnd timestamp (Unix seconds)

Post Analytics

get_post_details

Get details of a specific social post.

ParameterTypeRequiredDescription
post_typestringYesPost type (e.g., "twitter", "youtube")
post_idstringYesPost ID

Example:

curl -X POST https://api.hiveintelligence.xyz/api/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "get_post_details",
    "arguments": {
      "post_type": "twitter",
      "post_id": "1234567890"
    }
  }'

get_post_metrics

Get interactions over time for a post. Returns hourly interactions for posts less than 365 days old, otherwise daily.

ParameterTypeRequiredDescription
post_typestringYesPost type
post_idstringYesPost ID

Quick Reference

ToolDescription
get_topic_creatorsTop creators for a topic
get_topic_newsTop news for a topic
get_topic_postsTop posts for a topic
get_topic_metricsTopic summary metrics
get_trending_topicsTrending topics list
get_category_infoCategory summary info
get_category_topicsTop topics in category
get_category_postsTop posts in category
get_category_newsTop news in category
get_category_creatorsTop creators in category
get_categories_listTrending categories list
get_creators_listTrending creators list
get_creator_profileCreator details
get_creator_metricsCreator time series
get_creator_postsCreator's top posts
get_post_detailsPost details
get_post_metricsPost interaction metrics
Previous
Search & Discovery