apyhub
Back
▣ FINANCE

Get Global Crypto Market Overview API

What it does

Crypto Market Cap returns the global cryptocurrency market snapshot in a chosen quote currency. Send vs as usd, eur, gbp, btc, or eth, and get back the current market data in that denomination.

The response includes source, vs, totalVolume, btcDominance, ethDominance, totalMarketCap, marketCapChange24h, and activeCryptocurrencies. Numeric fields may be null when the upstream source does not have a value available, so you can handle missing market data without guessing.

Use Crypto Market Cap when you need to show a dashboard, drive portfolio analytics, or annotate a crypto summary with current dominance and capitalization figures. Because the output is already normalised around a single vs currency, it fits cleanly into charts, market overviews, and comparison views.

It is a lightweight read-only endpoint for applications that need a fast global crypto market reference rather than per-asset pricing or exchange order books.

GET
Global crypto market cap
https://api.eu.apyhub.com/corsair96/get-global-crypto-market-overview-api/crypto/market

QUICKSTART

GUIDE

Quickstart

Fetch the global crypto market overview in USD.

curl -X GET "https://api.eu.apyhub.com/corsair96/get-global-crypto-market-overview-api/crypto/market?vs=usd" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with source and vs required, plus optional market summary fields like totalVolume, btcDominance, ethDominance, totalMarketCap, marketCapChange24h, and activeCryptocurrencies.

{
  "source": "coinlore",
  "vs": "usd",
  "totalVolume": 1234567890.12,
  "btcDominance": 52.3,
  "ethDominance": 18.7,
  "totalMarketCap": 24567890123.45,
  "marketCapChange24h": 1.2,
  "activeCryptocurrencies": 12034
}
TRY ITLIVE · 30 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns a global crypto market overview in the requested quote currency. The response includes the selected vs currency and market-wide summary metrics such as total volume, market cap, dominance percentages, and active cryptocurrency count when available.

Query Parameter(s)

AttributeTypeMandatoryDescription
vsStringNoQuote currency to use for the overview. Allowed values: usd, eur, gbp, btc, eth. Default: usd.

Response

Returns a JSON object with required source and vs string fields, plus optional market summary fields. The vs field indicates the quote currency used for the returned overview; source identifies the data source.

ParameterTypeDescription
vsENUMQuote currency used in the response. Allowed values: usd, eur, gbp, btc, eth.
sourceStringData source name.
totalVolumeNumberTotal market volume. May be null.
btcDominanceNumberBTC dominance percentage. May be null.
ethDominanceNumberETH dominance percentage. May be null.
totalMarketCapNumberTotal market capitalization. May be null.
marketCapChange24hNumber24h change percentage. May be null.
activeCryptocurrenciesIntegerNumber of active cryptocurrencies. May be null.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.