Build with LunarCrush: API, MCP, and SDKs
Build with the LunarCrush API. One authenticated, JSON-over-HTTPS API gives you social sentiment, mentions and engagements, creators, topics, trending data, and price and market metrics for crypto and stocks — MCP-ready for Claude, ChatGPT, and Gemini. This is the canonical home for the LunarCrush developer documentation.
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:
| Plan | API access and rate limit |
|---|---|
| Hobby | Market data endpoints, 4 requests/min, 100 per day |
| Individual | Limited endpoints, 10 requests/min, 2,000/day |
| Builder | All endpoints, 100 requests/min, 20,000/day |
| Scale | All endpoints, 500 requests/min, 100,000/day |
| Enterprise | Custom |
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.