LunarCrush API docs

Crypto sentiment API

The LunarCrush crypto sentiment API returns sentiment, mention volume, creators, and topics from a single JSON-over-HTTPS surface. The base URL is https://lunarcrush.com/api4. Authenticate every call with an Authorization: Bearer <API_KEY> header. The same endpoints power the LunarCrush API product page.

A guest-documented sample that includes sentiment per coin:

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

What the API returns

One API covers social sentiment, mention and engagement volume, creators, topics, trending data, and price and market metrics for both crypto and stocks. Endpoints are organized into 9 groups:

• AI & MCP Server
• Topics
• Categories
• Creators
• Posts
• Coins
• Stocks
• Searches
• System

For example, /public/coins/list/v1 returns every tracked coin with price, market cap, Galaxy Score, AltRank, sentiment, and 24-hour social volume; /public/topic/<topic>/posts/v1 returns the top social posts for a topic; and /public/category/<category>/creators/v1 returns the most influential creators in a category.

Authentication

All requests use HTTPS and return JSON. Authenticate every call with an Authorization: Bearer <API_KEY> header. The base URL is https://lunarcrush.com/api4. The same key powers the webapp, the CLI, and the MCP server. You can hold up to five active keys at once; generate, label, rotate, and revoke them on the API Keys page. Keep keys secret — if one leaks, delete it and generate a new one.

Ways to build

• API Reference — every endpoint, with live requests and code samples in curl, JavaScript, Python, Go, and Rust.
• AI Reference — the same data as LLM-ready markdown at https://lunarcrush.ai, addressable by topic, creator, category, or post.
• CLI — query the API from your terminal or scripts.
• MCP Server — plug LunarCrush into Claude, Cursor, and any MCP-aware client.
• API Keys — generate and manage the keys that authenticate every surface.

Quick start

Authenticate with your key and call any endpoint:

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

Rate limits and plan gating

Every request counts against your plan's per-minute and daily quota. Limits and endpoint access are set by your subscription tier and match the plans on the pricing page:

The free Hobby tier is limited to market-data endpoints; social, creator, and AI endpoints unlock on paid plans. Enterprise limits are custom — talk to sales.

FAQ