[GUEST ACCESS MODE: Data is scrambled or limited to provide examples. Make requests using your API key to unlock full data. Check https://lunarcrush.ai/auth for authentication information.]

API3

Top Social Posts

Showing only X posts for non-authenticated requests. Use your API key in requests for full results.

"All targets Done 💸 Binance Futures $API3/ $USDT All take-profit targets achieved 😎 Profit: XXXXXXXX% 📈 Period: X Hours XX Minutes"
@Crypto_guy000 on X 2025-07-18 14:35:02 UTC XXX followers, XX engagements

"Gm ladies and gentlemen nice daily close on BTC Binance Futures $API3/ $USDT All take-profit targets achieved 😎 Profit: XXXXXXX% 📈 Period: X Hours XX Minutes"
@Crypto_guy000 on X 2025-07-18 14:18:07 UTC XXX followers, XX engagements

"Binance Futures $API3/ $USDT Take-Profit target X ✅ Profit: XXXXXXX% 📈 Period: X Hours X Minutes"
@Crypto_guy000 on X 2025-07-18 14:09:02 UTC XXX followers, XX engagements

"Binance Futures $API3/ $USDT Take-Profit target X ✅ Profit: XXXXXXX% 📈 Period: XX Minutes"
@Crypto_guy000 on X 2025-07-18 14:00:52 UTC XXX followers, XX engagements

Topic Posts

https://lunarcrush.com/api4/public/topic/:topic/posts/v1

Get the top posts for a social topic. If start time is provided the result will be the top posts by interactions for the time range. If start is not provided it will be the most recent top posts by interactions from the last XX hours.

input parameters:

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/posts/v1

Example response:

{
  "config": {
    "topic": "bitcoin",
    "type": "topic",
    "id": "bitcoin",
    "name": "Bitcoin",
    "symbol": "BTC",
    "generated": 1751552696
  },
  "data": [
    {
      "id": "1940767467934294480",
      "post_type": "tweet",
      "post_title": "NEW: 🇺🇸 Bitcoin & crypto market cap will \"probably go to $15-$20 TRILLION” once the Genius stablecoin legislation passes, says Trump's Digital Asset Director",
      "post_link": "https://x.com/BTC_Archive/status/1940767467934294480",
      "post_image": "https://pbs.twimg.com/media/Gu79uZ4WwAELycU.jpg",
      "post_created": 1751549996,
      "post_sentiment": 3.13,
      "creator_id": "twitter::970994516357472257",
      "creator_name": "BTC_Archive",
      "creator_display_name": "Bitcoin Archive",
      "creator_followers": 1726739,
      "creator_avatar": "https://pbs.twimg.com/profile_images/1938906052956700672/7aV7c-nF_200x200.jpg",
      "interactions_24h": 30978,
      "interactions_total": 31161
    }
  ]
}

Schema:

Topics List

https://lunarcrush.com/api4/public/topics/list/v1

Get a list of trending social topics.

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topics/list/v1

Example response:

{
  "data": [
    {
      "topic": "youtube",
      "title": "YouTube",
      "topic_rank": 1,
      "topic_rank_1h_previous": 1,
      "topic_rank_24h_previous": 1,
      "num_contributors": 412953,
      "num_posts": 836638,
      "interactions_24h": 3573313797
    }
  ]
}

Schema:

Topic Whatsup

https://lunarcrush.com/api4/public/topic/:topic/whatsup/v1

Generate an AI summary of the hottest news and social posts for a specific topic

input parameters:

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/whatsup/v1

Example response:

{
  "config": {
    "topic": "bitcoin",
    "generated": 1751552662
  },
  "summary": "Several major financial institutions and companies, such as BlackRock, Fidelity, and Microcloud Hologram Inc., are making significant moves in the Bitcoin space, including investing heavily in Bitcoin and launching new Bitcoin-related products. Additionally, regulatory developments, such as the SEC approving Grayscale's proposal to convert its fund into a spot ETF, are also having an impact. Meanwhile, some countries, like Pakistan, are exploring Bitcoin mining plans, while others, like South Africa, are seeing NFT marketplaces shut down due to market pressures."
}

Schema:

Topic Time Series v2

https://lunarcrush.com/api4/public/topic/:topic/time-series/v2

Get historical time series data for a social topic

input parameters:

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v2

Example response:

{
  "config": {
    "topic": "bitcoin",
    "id": "bitcoin",
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1750896000,
    "end": 1751559896,
    "bucket": "hour",
    "metrics": [],
    "generated": 1751552696
  },
  "data": [
    {
      "time": 1750896000,
      "contributors_active": 22916,
      "contributors_created": 1375,
      "interactions": 3979171,
      "posts_active": 46549,
      "posts_created": 1920,
      "sentiment": 77,
      "spam": 771,
      "alt_rank": 35,
      "circulating_supply": 19883512,
      "close": 107427,
      "galaxy_score": 72,
      "high": 107427,
      "low": 107324.55,
      "market_cap": 2136184884191,
      "market_dominance": 64.9097,
      "open": 107375.07,
      "social_dominance": 25.1594,
      "volume_24h": 51567717214
    }
  ]
}

Schema: