Social

1. Get Social Trend Data for a Coin

GET https://api.qa.trendmoon.ai/social/trend

Description:

• Retrieves social trend data for a specific cryptocurrency over time, including mentions, sentiment, and engagement metrics.

Parameters:

• contract_address (string, optional): Contract address of the coin.

• symbol (string, optional): Trading symbol of the coin (e.g., BTC, ETH).

• project_name (string, optional): Full name of the project (e.g., Bitcoin, Ethereum).

• coin_id (string, optional): Coingecko coin_id.

• date_interval (integer, optional, default: 30): Number of days of data to return.

• time_interval (string, optional, default: "1h"): Time interval for aggregation (1h, 1d).

Example request:

curl -X GET 'https://api.qa.trendmoon.ai/social/trend?symbol=SOL&date_interval=4&time_interval=1d' \
     -H 'accept: application/json' \
     -H 'Api-key: YOUR_API_KEY'

Response:

{
  "coin_id": "solana",
  "name": "Solana",
  "symbol": "sol",
  "contract_address": null,
  "market_cap_rank": 5,
  "trend_market_data": [
   {
      "date": "2025-04-01T00:00:00+00:00",
      "hour_social_perc_diff": 406.41247833622185,
      "day_social_perc_diff": 406.41247833622185,
      "sentiment_score": null,
      "symbol_count": 1715,
      "name_count": 1127,
      "social_mentions": 2922,
      "social_dominance": 0.12129204161465168,
      "relative_social_dominance": null,
      "price": 126.99667,
      "market_cap": 65073458808,
      "total_volume": 3530661268,
      "lc_posts_created": 11110,
      "lc_posts_active": 41624,
      "lc_interactions": 19348255,
      "lc_contributors_created": 5387,
      "lc_contributors_active": 17371,
      "lc_sentiment": 84,
      "lc_social_dominance": 0.08036099999999999,
      "lc_social_volume_24h": null,
      "lc_galaxy_score": 71,
      "lc_galaxy_score_previous": null,
      "lc_alt_rank": 227,
      "lc_alt_rank_previous": null
    },
    {
      "date": "2025-04-02T00:00:00+00:00",
      "hour_social_perc_diff": -100,
      "day_social_perc_diff": -100,
      "sentiment_score": null,
      "symbol_count": 0,
      "name_count": 0,
      "social_mentions": 0,
      "social_dominance": 0,
      "relative_social_dominance": null,
      "price": 118.82,
      "market_cap": 61098137240,
      "total_volume": 5824972423,
      "lc_posts_created": 11946,
      "lc_posts_active": 45916,
      "lc_interactions": 19407188,
      "lc_contributors_created": 5893,
      "lc_contributors_active": 18917,
      "lc_sentiment": 84,
      "lc_social_dominance": 0.083276,
      "lc_social_volume_24h": null,
      "lc_galaxy_score": 69,
      "lc_galaxy_score_previous": null,
      "lc_alt_rank": 339,
      "lc_alt_rank_previous": null
    },
    {
      "date": "2025-04-03T00:00:00+00:00",
      "hour_social_perc_diff": null,
      "day_social_perc_diff": null,
      "sentiment_score": null,
      "symbol_count": 2085,
      "name_count": 716,
      "social_mentions": 2939,
      "social_dominance": 0.03119475891192754,
      "relative_social_dominance": null,
      "price": 117.05626,
      "market_cap": 60114820903,
      "total_volume": 6262318134,
      "lc_posts_created": 12673,
      "lc_posts_active": 46573,
      "lc_interactions": 22131022,
      "lc_contributors_created": 6275,
      "lc_contributors_active": 19337,
      "lc_sentiment": 84,
      "lc_social_dominance": 0.086237,
      "lc_social_volume_24h": null,
      "lc_galaxy_score": 68,
      "lc_galaxy_score_previous": null,
      "lc_alt_rank": 304,
      "lc_alt_rank_previous": null
    },
    {
      "date": "2025-04-04T00:00:00+00:00",
      "hour_social_perc_diff": 27.35624362027901,
      "day_social_perc_diff": 27.35624362027901,
      "sentiment_score": null,
      "symbol_count": 2739,
      "name_count": 872,
      "social_mentions": 3743,
      "social_dominance": 0.04816404974553734,
      "relative_social_dominance": null,
      "price": 122.78487,
      "market_cap": 63119906836,
      "total_volume": 5182517335,
      "lc_posts_created": 13076,
      "lc_posts_active": 48070,
      "lc_interactions": 20185480,
      "lc_contributors_created": 6110,
      "lc_contributors_active": 19461,
      "lc_sentiment": 84,
      "lc_social_dominance": 0.08937300000000001,
      "lc_social_volume_24h": null,
      "lc_galaxy_score": 67,
      "lc_galaxy_score_previous": null,
      "lc_alt_rank": 30,
      "lc_alt_rank_previous": null
    },
    {
      "date": "2025-04-05T00:00:00+00:00",
      "hour_social_perc_diff": -58.96339834357467,
      "day_social_perc_diff": -58.96339834357467,
      "sentiment_score": null,
      "symbol_count": 969,
      "name_count": 406,
      "social_mentions": 1536,
      "social_dominance": 0.037035160626356416,
      "relative_social_dominance": null,
      "price": 117.8528,
      "market_cap": 60644818155,
      "total_volume": 3506856577,
      "lc_posts_created": 12576,
      "lc_posts_active": 55061,
      "lc_interactions": 18721733,
      "lc_contributors_created": 5774,
      "lc_contributors_active": 22729,
      "lc_sentiment": 84,
      "lc_social_dominance": 0.089986,
      "lc_social_volume_24h": null,
      "lc_galaxy_score": 67,
      "lc_galaxy_score_previous": null,
      "lc_alt_rank": 2,
      "lc_alt_rank_previous": null
    }
  ]
}

Response Fields:

• coin_id (string): Unique identifier for the coin, typically matching the Coingecko ID.

• name (string): Full name of the cryptocurrency.

• symbol (string): Trading symbol of the cryptocurrency.

• contract_address (string or null): Blockchain contract address if applicable, null for native coins.

• market_cap_rank (integer): Market capitalization rank among all cryptocurrencies.

• trend_market_data (array): Array of data points with social metrics over time.

Telegram-related metrics:

• date (string): Timestamp for the data point in ISO 8601 format.

• hour_social_perc_diff: Percentage change in social mentions over the last hour in Telegram groups

• day_social_perc_diff: Percentage change in social mentions over the last 24 hours in Telegram groups

• sentiment_score: Aggregated sentiment analysis score from Telegram messages (0-1, where 1 is most positive)

• symbol_count: Number of times the coin's symbol was mentioned in Telegram

• name_count: Number of times the coin's name was mentioned in Telegram

• social_mentions: Total number of mentions (both symbol and name) in Telegram

• social_dominance: Percentage of all crypto discussions that mention this coin (0-1)

• relative_social_dominance: Social dominance compared to the average of all tracked coins

Price related metrics:

• price (number): Current price in USD.

• market_cap (number): Market capitalization in USD.

• total_volume (number): Trading volume in USD over the last 24 hours.

LunarCrush metrics (prefixed with lc_):

• lc_posts_created (integer): Number of posts created about this coin on LunarCrush.

• lc_posts_active (integer or null): Number of active posts about this coin on LunarCrush.

• lc_interactions (integer or null): Number of interactions on posts about this coin.

• lc_contributors_created (integer or null): Number of unique contributors creating content.

• lc_contributors_active (integer or null): Number of active contributors discussing this coin.

• lc_sentiment (number): LunarCrush sentiment score (0-100 scale).

• lc_social_dominance (number): LunarCrush's calculation of social dominance.

• lc_social_volume_24h (number or null): 24-hour social volume according to LunarCrush.

• lc_galaxy_score (number): LunarCrush Galaxy Score, a proprietary metric (0-100 scale).

• lc_galaxy_score_previous (number or null): Previous Galaxy Score for comparison.

• lc_alt_rank (integer): LunarCrush AltRank, ranking among altcoins.

• lc_alt_rank_previous (integer or null): Previous AltRank for comparison.

Note: Fields with "lc" prefix contain data sourced from LunarCrush, a social analytics platform for cryptocurrencies.

2. Get Keyword Trend Over Time

GET https://api.qa.trendmoon.ai/social/keyword

Description:

• Retrieves aggregated trend data (message counts) for specific keywords, phrases, or comma-separated terms over a defined duration and time interval. Offers various matching strategies.

Parameters:

• keyword (string, required): The keyword, exact phrase, or comma-separated terms to search for (e.g., "bitcoin", "bitcoin moon", "btc,eth").

• duration (integer, optional, default: 7): Number of days to look back from the current time.

• time_interval (string, optional, default: 1d): Time interval for aggregation. Accepted values: 1h, 4h, 12h, 1d, 3d, 1w.

• match_mode (string, optional, default: exact): Strategy for matching the keyword(s). Accepted values: exact, any, all, fuzzy, partial.

  • exact: Match the exact keyword or phrase.

  • any: Match any of the comma-separated terms.

  • all: Match all comma-separated terms (order doesn't matter).

  • fuzzy: Match similar spellings (handles typos).

  • partial: Match if the keyword appears as part of a word

Example request:

curl -X 'GET' \
  'http://localhost:8000/social/keyword?keyword=taraxa%2C%20fomo.biz%2C%20tara&duration=5&time_interval=1d&match_mode=any' \
  -H 'accept: application/json' \
  -H 'Api-key: gui-admin-key'

Example response:

{
  "keyword": "taraxa, fomo.biz, tara",
  "match_mode": "any",
  "time_interval": "1d",
  "duration": 5,
  "data": [
    {
      "date": "2025-04-01T00:00:00Z",
      "count": 35
    },
    {
      "date": "2025-04-02T00:00:00Z",
      "count": 69
    },
    {
      "date": "2025-04-03T00:00:00Z",
      "count": 23
    },
    {
      "date": "2025-04-04T00:00:00Z",
      "count": 47
    },
    {
      "date": "2025-04-05T00:00:00Z",
      "count": 10
    }
  ]
}

Response fields:

• keyword (string): The keyword(s) used for the search.

• match_mode (string): The matching mode used (exact, any, all, fuzzy, partial).

• time_interval (string): The aggregation interval used (1h, 4h, 12h, 1d, 3d, 1w).

• duration (integer): The number of lookback days used.

• data (array): A list of data points for the trend.

  • date (string): The start timestamp of the interval (ISO 8601 format).

  • count (integer): The number of messages matching the keyword(s) within that interval.