API DocsSign inGet API key

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.

Base URL https://cap.coinceeper.com
Local Next.js rewrites /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_…).

  1. Create an account — key issued at signup.
  2. Or Sign in → Dashboard → API Keys.
  3. Export CC_API_KEY — never commit secrets.
Get API key

TypeScript SDK: sdks/typescript (@capceeper/sdk) · FAQ · Errors · Growth ops

GET/v1/usage
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.

Live previews, colors & embed codes

Customize theme colors and corner shape, preview each widget, then copy the script snippet.

Open Widgets gallery

Catalog 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.

GET/v1/public/market-pulse
# 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.

GET/v1/statusPublic

Service 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 }

GET/v1/status
curl -s -X GET \
  "https://cap.coinceeper.com/v1/status"
GET/v1/plansPublic

Plans catalog

Sellable Stage-1 plans (Free + Starter), rates, and payment channels (USDT / CC only).

Response: { stage, sellable_plans, plans, payment_channels }

GET/v1/plans
curl -s -X GET \
  "https://cap.coinceeper.com/v1/plans"
GET/v1/qualityPublic

Quality report

Latest worker quality snapshot (missing candles, FX coverage, degraded exchanges).

Response: Raw quality JSON from Redis, or { ok:false } if none yet.

GET/v1/quality
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.

GET/v1/public/marketsPublic

Markets table

Ranked assets with price, change%, market cap, circulating supply, volume, and spark closes. IP-limited as Free (sec/min).

Parameters

NameInDescription
limitquery1–300 (default 100).

Response: { data: MarketRow[], count, global }

GET/v1/public/markets
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/markets?limit=10"
GET/v1/public/globalPublic

Global metrics

Aggregate market cap, 24h volume, and BTC/ETH dominance.

Response: { market_cap_usd, volume_24h_usd, btc_dominance, eth_dominance, active_assets }

GET/v1/public/global
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/global"
GET/v1/public/assets/{id}Public

Public asset

Single asset catalog row by id or slug (e.g. bitcoin).

Parameters

NameInDescription
id requiredpathAsset id or slug.

Response: Asset object including circulating_supply when known.

GET/v1/public/assets/{id}
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/assets/bitcoin"
GET/v1/public/metadata/{id}Public

Metadata

Coin info: description, website, categories, links, platforms, supply, listed_at.

Parameters

NameInDescription
id requiredpathAsset id or slug.

Response: { id, slug, symbol, name, description, website, categories[], links, platforms, … }

GET/v1/public/metadata/{id}
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/metadata/bitcoin"
GET/v1/public/rankingsPublic

Rankings

Price, volume, market cap, and rank — same ranked table as /public/markets.

Parameters

NameInDescription
limitquery1–300 (default 300).

Response: { data: MarketRow[], count, global }

GET/v1/public/rankings
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/rankings?limit=10"
GET/v1/public/coins/{slug}/ohlcvPublic

Public OHLCV

Anonymous: Free plan only (1d, ≤30 days lookback). 1h/1m require Starter+ via API key (or CapCeeper.com site browse).

Parameters

NameInDescription
slug requiredpathAsset slug, e.g. bitcoin.
intervalqueryFree: 1d. Starter+: 1m | 1h | 1d.
daysqueryLookback days (Free max 30).

Response: { asset_id, slug, interval, data: [{time,open,high,low,close,volume}] }

GET/v1/public/coins/{slug}/ohlcv
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/coins/bitcoin/ohlcv?interval=1d&days=30"
GET/v1/public/coins/{slug}/ohlcv/latestPublic

OHLCV latest

Most recent candle. Anonymous public: Free intervals only (1d).

Parameters

NameInDescription
slug requiredpathAsset slug.
intervalqueryFree: 1d (default). Starter+: 1m | 1h | 1d.

Response: { asset_id, slug, interval, latest }

GET/v1/public/coins/{slug}/ohlcv/latest
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/coins/bitcoin/ohlcv/latest?interval=1d"
GET/v1/public/coins/{slug}/performancePublic

Price performance stats

Percent changes (1h/24h/7d/30d) plus 30d/365d high-low stats from candles.

Parameters

NameInDescription
slug requiredpathAsset slug.

Response: { percent_change, high_30d_usd, low_30d_usd, high_365d_usd, … }

GET/v1/public/coins/{slug}/performance
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/coins/bitcoin/performance"
GET/v1/public/gainers-losersPublic

Gainers & losers

Top 24h percentage gainers and losers among liquid quotes.

Parameters

NameInDescription
limitqueryPer side (default 10, max 50).

Response: { gainers[], losers[], window:"24h" }

GET/v1/public/gainers-losers
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/gainers-losers?limit=10"
GET/v1/public/indicesPublic

Market indices

Four CapCeeper widgets: Fear & Greed, Altcoin Season, Market Cap, Market Breadth.

Response: { indices: Index[], method, updated_at }

GET/v1/public/indices
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/indices"
GET/v1/public/market-pulsePublic

Market 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

NameInDescription
limitqueryMovers 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.

GET/v1/public/market-pulse
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/market-pulse?limit=5"
GET/v1/public/listings/newPublic

New listings

Newest assets in the catalog ordered by listed_at / created_at.

Parameters

NameInDescription
limitqueryDefault 20, max 100.

Response: { data: Asset[], count }

GET/v1/public/listings/new
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/listings/new?limit=20"
GET/v1/public/convertPublic

Convert (public)

Convert amount between crypto and fiat using live quotes + FX (Free fiat set).

Parameters

NameInDescription
amountqueryDefault 1.
from requiredquerySymbol or slug, e.g. BTC.
to requiredquerySymbol or fiat, e.g. USD.

Response: { amount, from, to, rate, result }

GET/v1/public/convert
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/convert?amount=1&from=BTC&to=USD"
GET/v1/public/exchangesPublic

Exchange 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

NameInDescription
market_typequeryspot (default). derivatives → Starter+.

Response: { market_type, count, data: ExchangeRankingRow[], source }

GET/v1/public/exchanges
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/exchanges?market_type=spot"
GET/v1/public/exchanges/{id}Public

Exchange detail (public)

Website profile snapshot for one venue (binance|okx|bybit|kucoin|gate|kraken|bitget|mexc|coinbase).

Parameters

NameInDescription
id requiredpathVenue id, e.g. binance.

Response: { data: ExchangeDetail, source }

GET/v1/public/exchanges/{id}
curl -s -X GET \
  "https://cap.coinceeper.com/v1/public/exchanges/binance"
GET/v1/public/exchanges/{id}/marketsPublic

Exchange markets (public)

Venue pairs. Anonymous Free: spot only, max 25. Perpetual/futures and higher limits require Starter+.

Parameters

NameInDescription
id requiredpathVenue id.
market_typequeryFree: spot. Starter+: spot | perpetual | futures.
limitqueryFree max 25; Starter max 100.

Response: { exchange_id, market_type, count, limit, data: ExchangeMarketPair[] }

GET/v1/public/exchanges/{id}/markets
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.

GET/v1/exchangesAPI key

Exchange 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

NameInDescription
X-API-Key requiredheaderSecret API key.
market_typequeryspot (default) or derivatives (Starter+).

Response: { market_type, count, data[], plan.exchanges, source }

GET/v1/exchanges
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/exchanges?market_type=spot"
GET/v1/exchanges/{id}API key

Exchange detail

Live spot (+ derivatives) volume, markets/coins counts, optional BTC volume equiv. Health fields require Starter+.

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.
id requiredpathbinance | okx | bybit | kucoin | gate | kraken | bitget | mexc | coinbase.

Response: { data: ExchangeDetail, plan.exchanges, source }

GET/v1/exchanges/{id}
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/exchanges/binance"
GET/v1/exchanges/{id}/marketsAPI key

Exchange 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

NameInDescription
X-API-Key requiredheaderSecret API key.
id requiredpathVenue id.
market_typequeryspot | perpetual | futures (plan-dependent).
limitqueryCapped by plan.exchanges.markets_limit.

Response: { exchange_id, market_type, count, limit, data: ExchangeMarketPair[], plan.exchanges }

GET/v1/exchanges/{id}/markets
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_…

GET/v1/quotes/latestAPI key

Latest quotes

Batch latest quotes. Prefer slugs or ids; omit both to get top batch sized by plan (Free ≤10, Starter ≤100).

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.
slugsqueryComma-separated slugs, e.g. bitcoin,ethereum.
idsqueryComma-separated asset ids (alternative to slugs).

Response: { data: Quote[] } with price_usd, changes, market_cap_usd, volume.

GET/v1/quotes/latest
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/quotes/latest?slugs=bitcoin,ethereum"
GET/v1/quotes/historicalAPI key

Historical quotes

Hourly closes for the last 24h. Requires Starter+.

Free plan receives HTTP 403.

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.
slug requiredqueryAsset slug.

Response: { asset_id, interval:"1h", data: candle[] }

GET/v1/quotes/historical
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.

GET/v1/coins/{slug}/ohlcvAPI key

OHLCV

Authenticated OHLCV with plan interval + lookback enforcement.

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.
slug requiredpathAsset slug.
intervalquery1m | 1h | 1d (plan-dependent).

Response: { asset_id, slug, interval, data: candle[] }

GET/v1/coins/{slug}/ohlcv
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.

GET/v1/assetsAPI key

List assets

Paginated asset catalog (id, slug, symbol, rank, circulating_supply).

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.
limitqueryPage size (default 100, max 300).
offsetqueryPagination offset.

Response: { data: Asset[], count }

GET/v1/assets
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/assets?limit=50"
GET/v1/assets/{id}API key

Get asset

Single asset by id or slug.

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.
id requiredpathAsset id or slug.

Response: Asset object.

GET/v1/assets/{id}
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/assets/ethereum"
GET/v1/metadata/{id}API key

Metadata

Authenticated coin info (description, categories, links, supply).

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.
id requiredpathAsset id or slug.

Response: Same shape as /v1/public/metadata/{id}.

GET/v1/metadata/{id}
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/metadata/bitcoin"
GET/v1/rankingsAPI key

Rankings

Ranked price/volume/market-cap table.

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.
limitquery1–300.

Response: { data, count, global }

GET/v1/rankings
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/rankings?limit=50"
GET/v1/gainers-losersAPI key

Gainers & losers

Top 24h movers.

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.
limitqueryPer side (default 10).

Response: { gainers[], losers[] }

GET/v1/gainers-losers
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/gainers-losers?limit=10"
GET/v1/listings/newAPI key

New listings

Newest catalog assets.

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.
limitqueryDefault 20.

Response: { data: Asset[] }

GET/v1/listings/new
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/listings/new"
GET/v1/coins/{slug}/performanceAPI key

Price performance

Multi-window percent changes and range stats.

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.
slug requiredpathAsset slug.

Response: { percent_change, high_30d_usd, … }

GET/v1/coins/{slug}/performance
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/coins/bitcoin/performance"
GET/v1/coins/{slug}/ohlcv/latestAPI key

OHLCV latest

Latest candle; 1m requires Starter+.

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.
slug requiredpathAsset slug.
intervalquery1m | 1h | 1d.

Response: { latest }

GET/v1/coins/{slug}/ohlcv/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).

GET/v1/convertAPI key

Convert

Convert amount using live quotes + FX. Free allows USD; Starter unlocks the full fiat list.

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.
amountqueryDefault 1.
from requiredqueryCrypto symbol/slug.
to requiredqueryFiat or crypto target.

Response: { amount, from, to, rate, result }

GET/v1/convert
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/convert?amount=2&from=ETH&to=USD"
GET/v1/fx/ratesAPI key

FX rates

USD-based fiat rates. Requires Starter+.

Free plan receives HTTP 403.

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.

Response: { base:"USD", rates: { EUR, GBP, ... } }

GET/v1/fx/rates
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/fx/rates"
GET/v1/globalAPI key

Global (authenticated)

Same payload as /v1/public/global; counted against plan credits when keyed.

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.

Response: Identical to public global.

GET/v1/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.

GET/v1/usageAPI key

Usage

Credits remaining and request counters for the authenticated account.

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.

Response: { plan, credits_remaining, today_requests, ... }

GET/v1/usage
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/usage"
GET/v1/keysAPI key

List API keys

Non-secret metadata for keys on this account (prefix + last4).

Parameters

NameInDescription
X-API-Key requiredheaderSecret API key.

Response: { data: [{ id, name, prefix, last4, created_at }] }

GET/v1/keys
curl -s -X GET \
  -H "X-API-Key: $CC_API_KEY" \
  "https://cap.coinceeper.com/v1/keys"
POST/v1/keysAPI key

Create API key

Mint a new key (shown once). Subject to plan key limit (Free 1, Starter 2).

Parameters

NameInDescription
X-API-Key requiredheaderExisting secret API key.
namebodyOptional label, e.g. "bots".

Response: { api_key, meta } — store api_key immediately.

POST/v1/keys
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).

WS/v1/streamAPI key

WebSocket 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

NameInDescription
api_keyqueryAPI key (preferred in browsers; WebSocket API cannot set headers).
X-API-KeyheaderAlternative to ?api_key= (curl, Python, servers).

Response: { type:"hello"|"quotes", data?, plan?, ts? }

WS/v1/stream
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"