Developers
Market Data API
Stage-1 reference for every public and authenticated market endpoint. Authenticated calls require X-API-Key — Free 150 req/min · Starter 450 req/min.
https://cap.coinceeper.com/v1/* to the same API. Prefer env var CC_API_KEY in samples.Authentication
Create an account → copy your one-time key → send X-API-Key: cc_… (or Authorization: Bearer cc_…).
- Create an account — key issued at signup.
- Or Sign in → Dashboard → API Keys.
- Export
CC_API_KEY— never commit secrets.
TypeScript SDK: sdks/typescript (@capceeper/sdk) · FAQ · Errors · Growth ops
curl -s -H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/usage"Playground
Run live requests against CapCeeper. Public paths work without a key; authenticated paths need a Free or Starter key from your dashboard.
// Response JSON appears here
Widgets
Embeddable market cards (tickers, Fear & Greed, movers, and more) — each is a one-line <script> loader. No API key (IP-limited as Free). Match your brand on the Widgets gallery.
Customize theme colors and corner shape, preview each widget, then copy the script snippet.
Open Widgets galleryCatalog from API
GET /v1/public/market-pulse returns embed.widgets[] with id, height, script_src, and ready snippet (script tag) for each card.
Keep CapCeeper attribution visible when embedding. Subject to the API License and Acceptable Use.
# List every embeddable widget (id, height, snippet)
curl -s "https://cap.coinceeper.com/v1/public/market-pulse?limit=5" | jq .embed.widgets
# Example — Fear & Greed only:
<script async src="https://cap.coinceeper.com/embed.js" data-widget="fear-greed" data-height="240"></script>Meta
Service health, plan catalog, and quality snapshots — no API key.
/v1/statusPublicService status
Liveness plus per-exchange lag/status and fan-out count. Call this before trading loops.
Response: { service, stage, version, exchanges{lag_ms,status}, fanout_n, time }
curl -s -X GET \
"https://cap.coinceeper.com/v1/status"/v1/plansPublicPlans catalog
Sellable Stage-1 plans (Free + Starter), rates, and payment channels (USDT / CC only).
Response: { stage, sellable_plans, plans, payment_channels }
curl -s -X GET \
"https://cap.coinceeper.com/v1/plans"/v1/qualityPublicQuality report
Latest worker quality snapshot (missing candles, FX coverage, degraded exchanges).
Response: Raw quality JSON from Redis, or { ok:false } if none yet.
curl -s -X GET \
"https://cap.coinceeper.com/v1/quality"Public market
Anonymous feeds capped at Free entitlements (rate + feature gates). No X-API-Key. CapCeeper.com product pages use a server-side site browse proxy for Starter-level UX — that token is never shipped to widgets or third parties.
/v1/public/marketsPublicMarkets table
Ranked assets with price, change%, market cap, circulating supply, volume, and spark closes. IP-limited as Free (sec/min).
Parameters
| Name | In | Description |
|---|---|---|
limit | query | 1–300 (default 100). |
Response: { data: MarketRow[], count, global }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/markets?limit=10"/v1/public/globalPublicGlobal metrics
Aggregate market cap, 24h volume, and BTC/ETH dominance.
Response: { market_cap_usd, volume_24h_usd, btc_dominance, eth_dominance, active_assets }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/global"/v1/public/assets/{id}PublicPublic asset
Single asset catalog row by id or slug (e.g. bitcoin).
Parameters
| Name | In | Description |
|---|---|---|
id required | path | Asset id or slug. |
Response: Asset object including circulating_supply when known.
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/assets/bitcoin"/v1/public/metadata/{id}PublicMetadata
Coin info: description, website, categories, links, platforms, supply, listed_at.
Parameters
| Name | In | Description |
|---|---|---|
id required | path | Asset id or slug. |
Response: { id, slug, symbol, name, description, website, categories[], links, platforms, … }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/metadata/bitcoin"/v1/public/rankingsPublicRankings
Price, volume, market cap, and rank — same ranked table as /public/markets.
Parameters
| Name | In | Description |
|---|---|---|
limit | query | 1–300 (default 300). |
Response: { data: MarketRow[], count, global }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/rankings?limit=10"/v1/public/coins/{slug}/ohlcvPublicPublic OHLCV
Anonymous: Free plan only (1d, ≤30 days lookback). 1h/1m require Starter+ via API key (or CapCeeper.com site browse).
Parameters
| Name | In | Description |
|---|---|---|
slug required | path | Asset slug, e.g. bitcoin. |
interval | query | Free: 1d. Starter+: 1m | 1h | 1d. |
days | query | Lookback days (Free max 30). |
Response: { asset_id, slug, interval, data: [{time,open,high,low,close,volume}] }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/coins/bitcoin/ohlcv?interval=1d&days=30"/v1/public/coins/{slug}/ohlcv/latestPublicOHLCV latest
Most recent candle. Anonymous public: Free intervals only (1d).
Parameters
| Name | In | Description |
|---|---|---|
slug required | path | Asset slug. |
interval | query | Free: 1d (default). Starter+: 1m | 1h | 1d. |
Response: { asset_id, slug, interval, latest }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/coins/bitcoin/ohlcv/latest?interval=1d"/v1/public/coins/{slug}/performancePublicPrice performance stats
Percent changes (1h/24h/7d/30d) plus 30d/365d high-low stats from candles.
Parameters
| Name | In | Description |
|---|---|---|
slug required | path | Asset slug. |
Response: { percent_change, high_30d_usd, low_30d_usd, high_365d_usd, … }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/coins/bitcoin/performance"/v1/public/gainers-losersPublicGainers & losers
Top 24h percentage gainers and losers among liquid quotes.
Parameters
| Name | In | Description |
|---|---|---|
limit | query | Per side (default 10, max 50). |
Response: { gainers[], losers[], window:"24h" }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/gainers-losers?limit=10"/v1/public/indicesPublicMarket indices
Four CapCeeper widgets: Fear & Greed, Altcoin Season, Market Cap, Market Breadth.
Response: { indices: Index[], method, updated_at }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/indices"/v1/public/market-pulsePublicMarket pulse (widget)
Four index widgets + Trending / Top gainers / Top losers. Response includes embed.script_src and embed.snippet (script loader) for third-party sites.
Gallery + embed codes: https://cap.coinceeper.com/widgets. Script: https://cap.coinceeper.com/embed.js with data-widget, data-theme, data-dir, data-symbols, colors. Ticker: data-dir=ltr|rtl and data-symbols=BTC,ETH (max 12).
Parameters
| Name | In | Description |
|---|---|---|
limit | query | Movers per side (default 5, max 20). |
Response: { indices[], movers:{…}, embed:{widgets[{id,title,path,height,script_src,iframe_src,snippet}], docs, api} } — one script tag per widget.
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/market-pulse?limit=5"/v1/public/trendingPublicTrending
Coins ranked by volume × |24h change| — active movers.
Parameters
| Name | In | Description |
|---|---|---|
limit | query | Default 10, max 50. |
Response: { data: MoverRow[], method }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/trending?limit=10"/v1/public/listings/newPublicNew listings
Newest assets in the catalog ordered by listed_at / created_at.
Parameters
| Name | In | Description |
|---|---|---|
limit | query | Default 20, max 100. |
Response: { data: Asset[], count }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/listings/new?limit=20"/v1/public/convertPublicConvert (public)
Convert amount between crypto and fiat using live quotes + FX (Free fiat set).
Parameters
| Name | In | Description |
|---|---|---|
amount | query | Default 1. |
from required | query | Symbol or slug, e.g. BTC. |
to required | query | Symbol or fiat, e.g. USD. |
Response: { amount, from, to, rate, result }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/convert?amount=1&from=BTC&to=USD"/v1/public/exchangesPublicExchange rankings (public)
Rank CapCeeper CEX venues by live volume. Anonymous Free: spot only, no venue health. Derivatives require Starter+.
IP-limited like Free. Prefer authenticated /v1/exchanges for apps.
Parameters
| Name | In | Description |
|---|---|---|
market_type | query | spot (default). derivatives → Starter+. |
Response: { market_type, count, data: ExchangeRankingRow[], source }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/exchanges?market_type=spot"/v1/public/exchanges/{id}PublicExchange detail (public)
Website profile snapshot for one venue (binance|okx|bybit|kucoin|gate|kraken|bitget|mexc|coinbase).
Parameters
| Name | In | Description |
|---|---|---|
id required | path | Venue id, e.g. binance. |
Response: { data: ExchangeDetail, source }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/exchanges/binance"/v1/public/exchanges/{id}/marketsPublicExchange markets (public)
Venue pairs. Anonymous Free: spot only, max 25. Perpetual/futures and higher limits require Starter+.
Parameters
| Name | In | Description |
|---|---|---|
id required | path | Venue id. |
market_type | query | Free: spot. Starter+: spot | perpetual | futures. |
limit | query | Free max 25; Starter max 100. |
Response: { exchange_id, market_type, count, limit, data: ExchangeMarketPair[] }
curl -s -X GET \
"https://cap.coinceeper.com/v1/public/exchanges/binance/markets?market_type=spot&limit=25"Exchanges
Plan-gated CEX rankings, profiles, and pair tables from direct exchange APIs. Free: spot + 25 pairs, no health. Starter+: Spot/Perp/Futures, health lag/status, higher pair limits.
/v1/exchangesAPI keyExchange rankings
Rank CapCeeper CEX venues by 24h volume and liquidity. Free: spot only, health omitted. Starter+: spot + derivatives with venue health.
Derivatives rankings return HTTP 403 on Free.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
market_type | query | spot (default) or derivatives (Starter+). |
Response: { market_type, count, data[], plan.exchanges, source }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/exchanges?market_type=spot"/v1/exchanges/{id}API keyExchange detail
Live spot (+ derivatives) volume, markets/coins counts, optional BTC volume equiv. Health fields require Starter+.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
id required | path | binance | okx | bybit | kucoin | gate | kraken | bitget | mexc | coinbase. |
Response: { data: ExchangeDetail, plan.exchanges, source }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/exchanges/binance"/v1/exchanges/{id}/marketsAPI keyExchange markets
Trading pairs for one venue sorted by volume. Free: spot · ≤25. Starter: all types · ≤100. Pro ≤250 · Business ≤500.
Perpetual/futures on Free → HTTP 403.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
id required | path | Venue id. |
market_type | query | spot | perpetual | futures (plan-dependent). |
limit | query | Capped by plan.exchanges.markets_limit. |
Response: { exchange_id, market_type, count, limit, data: ExchangeMarketPair[], plan.exchanges }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/exchanges/binance/markets?market_type=spot&limit=25"Quotes
Authenticated quote feeds. Send header X-API-Key: cc_…
/v1/quotes/latestAPI keyLatest quotes
Batch latest quotes. Prefer slugs or ids; omit both to get top batch sized by plan (Free ≤10, Starter ≤100).
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
slugs | query | Comma-separated slugs, e.g. bitcoin,ethereum. |
ids | query | Comma-separated asset ids (alternative to slugs). |
Response: { data: Quote[] } with price_usd, changes, market_cap_usd, volume.
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/quotes/latest?slugs=bitcoin,ethereum"/v1/quotes/historicalAPI keyHistorical quotes
Hourly closes for the last 24h. Requires Starter+.
Free plan receives HTTP 403.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
slug required | query | Asset slug. |
Response: { asset_id, interval:"1h", data: candle[] }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/quotes/historical?slug=bitcoin"OHLCV
Plan-gated candles. Free: 1d / 30d lookback. Starter: 1m, 1h, 1d with long lookback.
/v1/coins/{slug}/ohlcvAPI keyOHLCV
Authenticated OHLCV with plan interval + lookback enforcement.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
slug required | path | Asset slug. |
interval | query | 1m | 1h | 1d (plan-dependent). |
Response: { asset_id, slug, interval, data: candle[] }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/coins/bitcoin/ohlcv?interval=1h"Assets
Catalog of tracked coins for keyed clients.
/v1/assetsAPI keyList assets
Paginated asset catalog (id, slug, symbol, rank, circulating_supply).
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
limit | query | Page size (default 100, max 300). |
offset | query | Pagination offset. |
Response: { data: Asset[], count }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/assets?limit=50"/v1/assets/{id}API keyGet asset
Single asset by id or slug.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
id required | path | Asset id or slug. |
Response: Asset object.
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/assets/ethereum"/v1/metadata/{id}API keyMetadata
Authenticated coin info (description, categories, links, supply).
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
id required | path | Asset id or slug. |
Response: Same shape as /v1/public/metadata/{id}.
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/metadata/bitcoin"/v1/rankingsAPI keyRankings
Ranked price/volume/market-cap table.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
limit | query | 1–300. |
Response: { data, count, global }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/rankings?limit=50"/v1/gainers-losersAPI keyGainers & losers
Top 24h movers.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
limit | query | Per side (default 10). |
Response: { gainers[], losers[] }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/gainers-losers?limit=10"/v1/trendingAPI keyTrending
Active movers by volume × |24h change|.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
limit | query | Default 10. |
Response: { data[], method }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/trending"/v1/listings/newAPI keyNew listings
Newest catalog assets.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
limit | query | Default 20. |
Response: { data: Asset[] }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/listings/new"/v1/coins/{slug}/performanceAPI keyPrice performance
Multi-window percent changes and range stats.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
slug required | path | Asset slug. |
Response: { percent_change, high_30d_usd, … }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/coins/bitcoin/performance"/v1/coins/{slug}/ohlcv/latestAPI keyOHLCV latest
Latest candle; 1m requires Starter+.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
slug required | path | Asset slug. |
interval | query | 1m | 1h | 1d. |
Response: { latest }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/coins/bitcoin/ohlcv/latest?interval=1h"Convert & FX
Currency conversion and FX table (multi-fiat on Starter).
/v1/convertAPI keyConvert
Convert amount using live quotes + FX. Free allows USD; Starter unlocks the full fiat list.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
amount | query | Default 1. |
from required | query | Crypto symbol/slug. |
to required | query | Fiat or crypto target. |
Response: { amount, from, to, rate, result }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/convert?amount=2&from=ETH&to=USD"/v1/fx/ratesAPI keyFX rates
USD-based fiat rates. Requires Starter+.
Free plan receives HTTP 403.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
Response: { base:"USD", rates: { EUR, GBP, ... } }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/fx/rates"/v1/globalAPI keyGlobal (authenticated)
Same payload as /v1/public/global; counted against plan credits when keyed.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
Response: Identical to public global.
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/global"Keys & usage
Key management and credit counters for the API key owner.
/v1/usageAPI keyUsage
Credits remaining and request counters for the authenticated account.
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
Response: { plan, credits_remaining, today_requests, ... }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/usage"/v1/keysAPI keyList API keys
Non-secret metadata for keys on this account (prefix + last4).
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Secret API key. |
Response: { data: [{ id, name, prefix, last4, created_at }] }
curl -s -X GET \
-H "X-API-Key: $CC_API_KEY" \
"https://cap.coinceeper.com/v1/keys"/v1/keysAPI keyCreate API key
Mint a new key (shown once). Subject to plan key limit (Free 1, Starter 2).
Parameters
| Name | In | Description |
|---|---|---|
X-API-Key required | header | Existing secret API key. |
name | body | Optional label, e.g. "bots". |
Response: { api_key, meta } — store api_key immediately.
curl -s -X POST \
-H "X-API-Key: $CC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"bots"}' \
"https://cap.coinceeper.com/v1/keys"Streaming
WebSocket fan-out for Starter (1 connection).
/v1/streamAPI keyWebSocket stream
HTTP GET upgrade to WebSocket for live quote pushes. Requires Starter plan and API key.
Free plan receives HTTP 403. Auth via header or ?api_key=.
Parameters
| Name | In | Description |
|---|---|---|
api_key | query | API key (preferred in browsers; WebSocket API cannot set headers). |
X-API-Key | header | Alternative to ?api_key= (curl, Python, servers). |
Response: { type:"hello"|"quotes", data?, plan?, ts? }
curl -s -N -H "X-API-Key: $CC_API_KEY" \
--http1.1 \
-H "Connection: Upgrade" -H "Upgrade: websocket" \
-H "Sec-WebSocket-Version: 13" -H "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==" \
"https://cap.coinceeper.com/v1/stream"