coinmarketcaplisted

# CoinMarketCap Skill Reference files: - [`references/endpoints.md`](references/endpoints.md) — full catalog by category with credit formulas - [`references/credits.md`](references/credits.md) — budget rules, cost estimation, plan tiers - [`references/patterns.md`](references/patterns.md) — batching, caching, CMC vs alternatives - [`references/examples/*.py`](references/examples/) — working Python scripts --- ## 🚨 Rule #1: credits, not requests CoinMarketCap meters by **credits**, not by request count. The formula is: ``` credits_per_call = max(1, ceil(data_points_returned / 100)) ``` Where `data_points ≈ rows × columns × (1 + extra_convert_currencies)`. **Cheap calls (1 credit):** - Up to 100 cryptos on `quotes/latest` - Up to 200 cryptos on `listings/latest` - Any single-token lookup (map, info, pools) - `global-metrics`, `key/info`, `fiat/map` **Expensive calls:** - `listings/latest?limit=5000` = **25 credits** (verified) - `ohlcv/historical` with many points × many cryptos = points / 100 - `market-pairs/latest` with 500+ pairs - Adding `convert=USD,EUR,GBP` → +1 credit per extra currency **Always check `status.credit_count`** in response and log it. ## 🚨 Rule #2: budget thresholds (applied per call) | Estimated credits | Action | |-------------------|--------| | `< 50` | Proceed silently | | `50–200` | Announce cost + reason before calling | | `> 200` | STOP. Propose alternative (narrower `limit`, targeted `id` list, cached data, different endpoint). Execute