# Global Crypto Market API > Live aggregate data for the whole cryptocurrency market — the top-down view, not a single coin, exchange or trading pair, powered by the public CoinGecko global feed, no key, nothing stored. The overview endpoint returns the combined market capitalisation of all crypto, the total 24-hour trading volume, the market-wide 24-hour cap change, the number of active cryptocurrencies and markets, and the ongoing / upcoming / ended ICO counts. The dominance endpoint returns each leading coin's share of total market cap — Bitcoin dominance, Ether dominance, the stablecoin share and the long-tail rest — the single most-watched gauge of where money sits in crypto. The defi endpoint returns the decentralized-finance sub-market: its market cap, its share of total crypto, its 24-hour volume and the largest DeFi token. Track total market cap, BTC dominance and the DeFi share as live JSON. This is the whole-market aggregate cut — distinct from the single-coin, single-exchange and cross-exchange coin-markets APIs in the catalogue. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/globalmarket-api/..." ``` ## Pricing - **Free** (Free) — 16,000 calls/Mo, 3 req/s - **Analyst** ($9/Mo) — 195,000 calls/Mo, 10 req/s - **Pro** ($25/Mo) — 840,000 calls/Mo, 28 req/s - **Scale** ($58/Mo) — 2,950,000 calls/Mo, 65 req/s ## Endpoints ### Overview #### `GET /v1/overview` — Total market cap, volume, cap change, counts **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/globalmarket-api/v1/overview" ``` **Response:** ```json { "data": { "source": "CoinGecko", "markets": 1484, "ended_icos": 3376, "updated_at": "2026-06-11T16:42:38.000Z", "ongoing_icos": 49, "upcoming_icos": 0, "total_market_cap_btc": 35610911.07, "total_market_cap_usd": 2230316550039, "total_volume_24h_usd": 76254935665, "active_cryptocurrencies": 17319, "market_cap_change_24h_pct": 0.68 }, "meta": { "timestamp": "2026-06-11T16:46:50.347Z", "request_id": "71fdf676-a463-4092-8a0e-a1284e8bb750" }, "status": "ok", "message": "Overview retrieved successfully", "success": true } ``` ### Dominance #### `GET /v1/dominance` — Each leading coin share of total market cap **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/globalmarket-api/v1/dominance" ``` **Response:** ```json { "data": { "note": "Each coin's share of total crypto market cap. 'others_pct' is everything outside the listed coins.", "count": 10, "source": "CoinGecko", "dominance": [ { "coin": "BTC", "dominance_pct": 56.279 }, { "coin": "ETH", "dominance_pct": 8.889 }, { "coin": "USDT", "dominance_pct": 8.368 }, { "coin": "BNB", "dominance_pct": 3.618 }, { "coin": "USDC", "dominance_pct": 3.356 }, { "coin": "XRP", "dominance_pct": 3.086 }, { "coin": "SOL", "dominance_pct": 1.702 }, { "coin": "TRX", "dominance_pct": 1.346 }, { "coin": "FIGR_HELOC", "dominance_pct": 0.867 }, { "coin": "STETH", "dominance_pct": 0.657 } ], "others_pct": 11.832 }, "meta": { "timestamp": "2026-06-11T16:46:50.467Z", "request_id": "4471c320-42cf-4a42-977b-4762cc083bc7" }, "status": "ok", "message": "Dominance retrieved successfully", "success": true } ``` ### DeFi #### `GET /v1/defi` — The DeFi sub-market overview **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/globalmarket-api/v1/defi" ``` **Response:** ```json { "data": { "note": "The decentralized-finance sub-market. defi_dominance is DeFi's share of total crypto market cap.", "source": "CoinGecko", "top_coin_name": "Lido Staked Ether", "defi_to_eth_ratio": 42.2, "defi_dominance_pct": 3.75, "eth_market_cap_usd": 198135604965, "defi_market_cap_usd": 83613259686, "trading_volume_24h_usd": 3798159287, "top_coin_defi_dominance_pct": 17.509 }, "meta": { "timestamp": "2026-06-11T16:46:50.885Z", "request_id": "4a1b02d6-dfaf-4a25-b4f7-263a715603b9" }, "status": "ok", "message": "DeFi market retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/globalmarket-api/v1/meta" ``` **Response:** ```json { "data": { "note": "Dollar amounts are USD. Dominance is each coin's percentage of total crypto market cap. Results are cached briefly to protect the keyless rate-limited upstream.", "source": "CoinGecko global (api.coingecko.com/api/v3/global, live)", "service": "globalmarket-api", "endpoints": { "GET /v1/defi": "The DeFi sub-market — market cap, dominance, 24h volume and largest DeFi token.", "GET /v1/meta": "This document.", "GET /v1/overview": "Total crypto market cap, 24h volume, 24h cap change, active cryptos, markets, ICO counts.", "GET /v1/dominance": "Each leading coin's share of total market cap, ranked, plus the long-tail 'others'." }, "description": "Live aggregate data for the whole cryptocurrency market from CoinGecko — the top-down view, not a single coin or exchange. The overview endpoint returns total market capitalisation, total 24h volume, the market-wide 24h cap change, active cryptocurrency and market counts and ICO counts; the dominance endpoint returns each leading coin's share of total market cap (Bitcoin dominance, Ether dominance, the stablecoin share, the rest); the defi endpoint returns the DeFi sub-market (its market cap, dominance, volume and largest token). Live, no key, nothing stored. The whole-market aggregate cut — distinct from the single-coin, single-exchange and cross-exchange coin-markets APIs.", "upstream_status": "ok", …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/globalmarket-api OpenAPI spec: https://www.oanor.com/api/globalmarket-api/openapi.json