# CryptoBoss — Crypto API for AI Agents
> 42+ MCP tools for autonomous agents. Zero signup. Post-paid $1 USDC on Solana.
> Base URL: https://cryptoboss.space
> MCP endpoint: https://cryptoboss.space/mcp
> MCP discovery: https://cryptoboss.space/.well-known/mcp.json
> Payment: $1 USDC (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v) on Solana mainnet — post-paid, no subscription

## Quick Start
```
# Generate free key (no email, no signup)
curl -X POST https://cryptoboss.space/api/register
# → {"key":"cd_abc123","balance_usd":"$1.00"}

# Use it immediately
curl -H "x-api-key: cd_abc123" 'https://cryptoboss.space/api/price?coins=bitcoin,ethereum,solana'
```

## MCP Config
```json
{"mcpServers":{"cryptoboss":{"type":"streamableHttp","url":"https://cryptoboss.space/mcp"}
```

## All 42+ MCP Tools by Category

### Market Data (9)
| Tool | Description | Price |
|------|-------------|-------|
| register | Get free API key with $1 credit | Free |
| check_usage | Check key balance and usage | Free |
| get_price | Real-time prices for 15k+ coins | $0.01 |
| get_trending | Trending coins on CoinGecko | $0.01 |
| get_top | Top coins by market cap | $0.01 |
| get_top_gainers | Top 24h gainers | $0.02 |
| get_top_losers | Top 24h losers | $0.02 |
| get_global | Global market stats (cap, volume, dominance) | $0.01 |
| get_coin | Detailed coin info (ATH, supply, categories) | $0.01 |

### Intelligence (5)
| Tool | Description | Price |
|------|-------------|-------|
| compare_coins | Side-by-side coin comparison with metrics | $0.02 |
| market_correlation | Correlation matrix between coins | $0.03 |
| get_stablecoins | Stablecoin market data & dominance | $0.01 |
| trending_categories | Hot categories ranked by change | $0.01 |
| get_price_summary | Price statistics: high, low, avg, volatility | $0.02 |

### DeFi (5)
| Tool | Description | Price |
|------|-------------|-------|
| get_defi_yields | DeFi yield opportunities | $0.02 |
| get_defi_tvl | Protocols by TVL | $0.02 |
| get_defi_pools | Liquidity pool data | $0.02 |
| get_defi_protocol | Protocol breakdown | $0.02 |
| get_summary | Aggregated market overview | $0.01 |

### Meme & DEX (3)
| Tool | Description | Price |
|------|-------------|-------|
| get_meme_scan | Scan new meme tokens | $0.05 |
| get_meme_analyze | Deep rug risk analysis | $0.05 |
| get_meme_trending | Trending DEX tokens | $0.03 |

### Gas & On-Chain (2)
| Tool | Description | Price |
|------|-------------|-------|
| get_gas | Ethereum gas (fast/average/slow) | $0.005 |
| get_gas_all | Multi-chain gas tracker | $0.01 |

### Sentiment & Aggregated (2)
| Tool | Description | Price |
|------|-------------|-------|
| get_fear_greed | Fear & Greed Index with history | $0.005 |
| get_categories | Top crypto categories | $0.01 |

### Search & OHLC (3)
| Tool | Description | Price |
|------|-------------|-------|
| get_search | Search coins by name or symbol | $0.005 |
| get_ohlc | OHLC chart data (1d, 7d, 30d, 90d) | $0.01 |
| get_exchanges | Exchange listings | $0.01 |

### Security (2)
| Tool | Description | Price |
|------|-------------|-------|
| analyze_contract | Deep contract audit + risk scoring | $0.05 |
| check_approvals | Token approval risk detection | $0.03 |

### On-Chain Analytics (3)
| Tool | Description | Price |
|------|-------------|-------|
| get_whale_moves | Whale transaction tracker | $0.03 |
| get_token_holders | Token holder distribution analysis | $0.02 |
| get_liquidations | Liquidation risk watch | $0.02 |

### Portfolio (2)
| Tool | Description | Price |
|------|-------------|-------|
| get_portfolio_value | Calculate portfolio value from holdings | $0.01 |
| get_portfolio_health | Portfolio diversification analysis | $0.02 |

### Alerts (3)
| Tool | Description | Price |
|------|-------------|-------|
| set_price_alert | Create price alert (above/below target) | $0.01 |
| get_alerts | List your active price alerts | $0.005 |
| delete_alert | Delete a price alert by ID | $0.005 |

### Trading (3)
| Tool | Description | Price |
|------|-------------|-------|
| get_arbitrage | Cross-market arbitrage scanner | $0.03 |
| get_top_volume | Top coins by 24h trading volume | $0.01 |
| get_social_sentiment | Social sentiment & market mood | $0.02 |

### Infrastructure (1)
| Tool | Description | Price |
|------|-------------|-------|
| get_network_health | Blockchain network health check | $0.01 |

## REST API Endpoints
```
# Market Data
GET /api/register             Free key generation       $0
GET /api/price                Real-time prices          $0.01
GET /api/trending             Trending coins            $0.01
GET /api/top                  Top by market cap         $0.01
GET /api/top-gainers          24h gainers               $0.02
GET /api/top-losers           24h losers                $0.02
GET /api/global               Global market stats       $0.01
GET /api/coin/{id}            Coin details              $0.01
GET /api/categories           Categories                $0.01
GET /api/search?q=            Coin search               $0.005
GET /api/ohlc?coin=&days=     OHLC chart data           $0.01
GET /api/exchanges            Exchange listings         $0.01

# DeFi
GET /api/defi/yields          DeFi yields               $0.02
GET /api/defi/tvl             Protocol TVL              $0.02
GET /api/defi/pools           Liquidity pools           $0.02
GET /api/defi/protocol/{id}   Protocol breakdown        $0.02

# Meme & DEX
GET /api/meme/scan            Meme token scanner        $0.05
GET /api/meme/analyze         Rug risk analysis         $0.05
GET /api/meme/trending        Trending memes            $0.03

# Gas
GET /api/gas                  Gas tracker               $0.005
GET /api/gas/all              Multi-chain gas           $0.01

# Sentiment
GET /api/fear-greed           Sentiment index           $0.005
GET /api/summary              Market overview           $0.01

# Security
GET /api/security/audit       Contract audit            $0.05

# On-Chain
GET /api/whale/transactions   Whale tracker             $0.03
GET /api/whale/holders        Token holders             $0.02
GET /api/market/liquidations  Liquidation risk          $0.02
GET /api/market/top-volume    Top volume coins          $0.01

# Portfolio
GET /api/portfolio/value      Portfolio value           $0.01
GET /api/portfolio/health     Portfolio health          $0.02

# Alerts
POST /api/alerts/create       Create alert              $0.01
GET /api/alerts/list          List alerts               $0.005
POST /api/alerts/delete       Delete alert              $0.005

# Trading
GET /api/arbitrage/scan       Arbitrage scanner         $0.03
GET /api/sentiment/market     Sentiment analysis        $0.02

# Infrastructure
GET /api/network/status       Network health            $0.01

# Intelligence
GET /api/market/compare       Coin comparison           $0.02
GET /api/market/correlation   Correlation matrix        $0.03
GET /api/market/stablecoins   Stablecoin market data    $0.01
GET /api/market/trending-categories Hot categories       $0.01
GET /api/price/summary        Price summary stats       $0.02
```

## Data Sources
- **CoinGecko**: Prices, trending, top, global, coin details, categories, search, OHLC, exchanges
- **DeFiLlama**: Yields, TVL, liquidity pools, protocols, gas, liquidation data
- **DexScreener**: Meme token scan, analysis, trending DEX tokens, whale tracking, contract audit, approval checks
- **Alternative.me**: Fear & Greed Index
- **Etherscan**: Gas prices

## Payment
Post-paid billing on Solana mainnet:
- **Free credit**: $1 USDC per key (no upfront payment)
- **Token**: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC)
- **Wallet**: DEXbxpDbbj5AnZSqfAhuftvjrtXwjoWW1PgrxmVjuZef
- **Facilitator**: https://facilitator.leash.market
- **Pricing**: $0.005–$0.05 per call (~100–200 calls per $1)

## Why CryptoBoss
- **Zero signup**: No email, no KYC, no subscription — one click to a key
- **Post-paid**: $1 free credit upfront, pay USDC only when exhausted
- **MCP-native**: 42+ tools across 10 categories auto-discovered by Claude, Cursor, Cline, Windsurf
- **Global edge**: Cloudflare Workers — sub-50ms response times
- **Rich data**: Market Data, DeFi, Meme & DEX, Security, On-Chain Analytics, Portfolio, Alerts, Sentiment, Trading, Gas, Networks
- **Solana payments**: $1 USDC via Leash Market facilitator — no credit card needed
- **AI-optimized**: Built for autonomous agent workflows — zero-hassle billing, auto-discoverable tools, categorized by use case