# CryptoData API — AI Agent Intelligence Layer
> Crypto intelligence API designed for AI agents. 19 data endpoints + key management. Post-paid $1 USDC billing on Solana.
> Base URL: https://cryptodata-api.datachain.workers.dev
> MCP endpoint: https://cryptodata-api.datachain.workers.dev/mcp
> MCP discovery: https://cryptodata-api.datachain.workers.dev/.well-known/mcp.json
> Payment: $1 USDC on Solana mainnet — pay only when credit exhausted. No subscription, no signup.

## Quick Start
```
curl -X POST https://cryptodata-api.datachain.workers.dev/api/register
# → {"key":"cd_...","balance_usd":"$1.00"}
curl -H "x-api-key: cd_..." 'https://cryptodata-api.datachain.workers.dev/api/price?coins=bitcoin,ethereum'
```

## MCP Config (paste into Claude/Cursor/Cline/Codex)
```json
{"mcpServers":{"cryptodata":{"type":"streamableHttp","url":"https://cryptodata-api.datachain.workers.dev/mcp"}}}
```

## Available MCP Tools (21 total)
1. `register` — Get free API key with $1 credit (free)
2. `check_usage` — Check key balance and usage
3. `get_price` — Real-time prices, 24h change, market cap ($0.01)
4. `get_trending` — Trending coins ($0.01)
5. `get_top` — Top by market cap ($0.01)
6. `get_top_gainers` — Top 24h gainers ($0.02)
7. `get_top_losers` — Top 24h losers ($0.02)
8. `get_global` — Global market stats ($0.01)
9. `get_coin` — Detailed coin info ($0.01)
10. `get_categories` — Top categories ($0.01)
11. `get_defi_yields` — DeFi yield opportunities ($0.02)
12. `get_defi_tvl` — Protocols by TVL ($0.02)
13. `get_defi_pools` — Liquidity pools ($0.02)
14. `get_defi_protocol` — Protocol breakdown ($0.02)
15. `get_meme_scan` — Scan new meme tokens ($0.05)
16. `get_meme_analyze` — Rug risk analysis ($0.05)
17. `get_meme_trending` — Trending DEX tokens ($0.03)
18. `get_gas` — Ethereum gas ($0.005)
19. `get_gas_all` — Multi-chain gas ($0.01)
20. `get_fear_greed` — Fear & Greed Index ($0.005)
21. `get_summary` — One-call market overview ($0.01)

## Data Sources
- CoinGecko (prices, trending, top, global, coin detail, categories)
- DeFiLlama (yields, TVL, pools, protocols, gas)
- DexScreener (meme token scan, analysis, trending)
- Alternative.me (Fear & Greed Index)
- Etherscan (gas prices)

## Why This API
- **Zero signup**: No email, no KYC, no subscription
- **Post-paid**: $1 free credit, pay USDC only when exhausted
- **MCP-native**: AI agents discover automatically via MCP protocol
- **Rich data**: 19 endpoints covering everything from BTC price to meme coin rug checks
- **Solana payments**: $1 USDC via Leash Market facilitator