# 🌙 LunarCrush Universal API

## 🚀 Production-Ready GraphQL API (100% Success Rate)

**Live API**: https://lunarcrush.cryptoguard-api.workers.dev
**Documentation**: https://lunarcrush.cryptoguard-api.workers.dev/docs
**GraphQL Playground**: https://lunarcrush.cryptoguard-api.workers.dev/graphql
**Health Check**: Use GraphQL systemHealth resolver


## 🎯 Quick Start

### GraphQL Query Example:
```graphql
query {
  systemHealth {
    status
    uptime
    version
  }

  ping {
    status
    timestamp
  }

  getCoinsList {
    name
    symbol
    price
    market_cap
  }
}
```

### Authentication:
- Add header: `x-api-key: YOUR_LUNARCRUSH_API_KEY`
- Get API key: https://lunarcrush.com/developers

### Available Data:
- 🪙 **Cryptocurrencies**: Real-time prices, market data, social sentiment
- 📈 **Topics**: Trending topics and social intelligence
- 🏢 **Stocks**: Stock market data with social metrics
- 🎨 **NFTs**: NFT collection data and trends
- 👥 **Creators**: Social media influencer analytics
- 📊 **Categories**: Organized data by themes (DeFi, Gaming, AI, etc.)
- 🔍 **Search**: Post search and system changes tracking

### Key Features:
- **41 GraphQL Resolvers**: Complete LunarCrush API coverage
- **Real-time Data**: 100M+ daily social interactions
- **Intelligent Caching**: KV store with TTL management
- **Type Safety**: Auto-generated TypeScript definitions
- **Security-First**: Input validation, secure headers, no unnecessary endpoints

### Response Format:
This endpoint returns HTML by default. Add `?format=text` or use appropriate Accept headers for structured data.

### Support:
- Interactive Docs: https://lunarcrush.cryptoguard-api.workers.dev/docs
- GraphQL Health: Use systemHealth resolver in GraphQL
- GraphQL Schema: https://lunarcrush.cryptoguard-api.workers.dev/graphql

Built with ❤️ for the crypto community