# Crypto Market Overview API > Live whole-market crypto data — the bird's-eye view of the market, not single coins — served from the public CoinGecko feed with no key and nothing cached. The global endpoint returns the total crypto market capitalisation and 24-hour volume, the market-cap dominance of the biggest coins (Bitcoin around 56%, Ethereum around 9%), the 24-hour market-cap change, and how many active cryptocurrencies and markets exist. The trending endpoint returns the coins people are searching for most right now — CoinGecko's trending list — with each coin's symbol, market-cap rank, price and 24-hour change. The treasuries endpoint returns the public companies that hold Bitcoin or Ethereum on their balance sheets, ranked by holdings, with each company's coin count and current USD value and the grand total — Strategy alone holds over 800,000 BTC worth tens of billions of dollars. This is the market-overview, sentiment and institutional-flow layer for any crypto dashboard, research, screener or news app. Live from CoinGecko, nothing stored. Distinct from single-coin price, sector and TVL APIs — this is the whole market, what's trending, and who's holding. 4 endpoints. ## 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/cryptomarket-api/..." ``` ## Pricing - **Free** (Free) — 10,500 calls/Mo, 3 req/s - **Starter** ($11/Mo) — 132,000 calls/Mo, 8 req/s - **Pro** ($28/Mo) — 640,000 calls/Mo, 15 req/s - **Scale** ($65/Mo) — 3,200,000 calls/Mo, 30 req/s ## Endpoints ### Market #### `GET /v1/global` — Whole-market snapshot **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/cryptomarket-api/v1/global" ``` **Response:** ```json { "data": { "markets": 1482, "dominance": [ { "coin": "BTC", "dominance_pct": 55.93 }, { "coin": "ETH", "dominance_pct": 9 }, { "coin": "USDT", "dominance_pct": 8.39 }, { "coin": "BNB", "dominance_pct": 3.62 }, { "coin": "USDC", "dominance_pct": 3.37 }, { "coin": "XRP", "dominance_pct": 3.18 }, { "coin": "SOL", "dominance_pct": 1.71 }, { "coin": "TRX", "dominance_pct": 1.38 }, { "coin": "FIGR_HELOC", "dominance_pct": 0.87 }, { "coin": "STETH", "dominance_pct": 0.66 } ], "updated_at": 1781036348, "btc_dominance_pct": 55.93, "eth_dominance_pct": 9, "total_market_cap_usd": 2225866078571, "total_volume_24h_usd": 95151978892, "active_cryptocurrencies": 17348, "market_cap_change_24h_pct": -1.81 }, "meta": { "timestamp": "2026-06-09T20:26:45.938Z", "request_id": "96e780c8-e96f-4d29-832e-7ef5d11b6070" }, "status": "ok", …(truncated, see openapi.json for full schema) ``` #### `GET /v1/treasuries` — Public-company BTC/ETH holdings **Parameters:** - `coin` (query, optional, string) — bitcoin | ethereum (default bitcoin) Example: `bitcoin` - `limit` (query, optional, string) — How many companies (default 20, max 100) Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/cryptomarket-api/v1/treasuries?coin=bitcoin&limit=20" ``` **Response:** ```json { "data": { "coin": "bitcoin", "companies": [ { "name": "Strategy", "symbol": "MSTR.US", "country": "US", "holdings": 845256, "current_value_usd": 52404453122, "pct_of_total_supply": 4.025 }, { "name": "XXI", "symbol": "XXI.US", "country": "US", "holdings": 43514, "current_value_usd": 2697794956, "pct_of_total_supply": 0.207 }, { "name": "Metaplanet", "symbol": "3350.T", "country": "JP", "holdings": 40177, "current_value_usd": 2490906557, "pct_of_total_supply": 0.191 }, { "name": "MARA Holdings", "symbol": "MARA.US", "country": "US", "holdings": 35303, "current_value_usd": 2188726739, "pct_of_total_supply": 0.168 }, { "name": "Bitcoin Standard Treasury Company", "symbol": "CEPO.US", "country": "US", "holdings": 30021, "current_value_usd": 1861251606, "pct_of_total_supply": 0.143 }, { "name": "Galaxy Digital Holdings Ltd", "s …(truncated, see openapi.json for full schema) ``` #### `GET /v1/trending` — Trending coins right now **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/cryptomarket-api/v1/trending" ``` **Response:** ```json { "data": { "coins": [ { "id": "humanity", "name": "Humanity", "symbol": "H", "price_usd": 0.2077520717087282, "market_cap": "$376,009,026", "market_cap_rank": 122, "price_change_24h_pct": -70.98 }, { "id": "xmaquina", "name": "XMAQUINA", "symbol": "DEUS", "price_usd": 0.03715363193318744, "market_cap": "$18,728,130", "market_cap_rank": 846, "price_change_24h_pct": 10.75 }, { "id": "konet", "name": "KONET", "symbol": "KONET", "price_usd": 0.053780190867659915, "market_cap": "$24,069,569", "market_cap_rank": 729, "price_change_24h_pct": 8.81 }, { "id": "pudgy-penguins", "name": "Pudgy Penguins", "symbol": "PENGU", "price_usd": 0.006715345784838958, "market_cap": "$422,107,920", "market_cap_rank": 113, "price_change_24h_pct": -2.78 }, { "id": "sahara-ai", "name": "Sahara AI", "symbol": "SAHARA", "price_usd": 0.02054247493992795, "market_cap": …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Spec **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/cryptomarket-api/v1/meta" ``` **Response:** ```json { "data": { "source": "CoinGecko public API (live)", "service": "cryptomarket-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/global": "Whole-market snapshot: total market cap, volume, BTC/ETH dominance, 24h change, active coins.", "GET /v1/trending": "The coins trending in search right now (rank, price, 24h change).", "GET /v1/treasuries": "Public companies holding Bitcoin/Ethereum (coin=bitcoin|ethereum, limit up to 100)." }, "description": "Live whole-market crypto data from CoinGecko: the global market snapshot (total market cap and 24h volume, BTC/ETH market-cap dominance, 24h change, active coins and markets); the trending coins people are searching for most right now with rank, price and 24h change; and the public companies holding Bitcoin or Ethereum on their balance sheets, ranked by holdings with USD value and totals. Live, no key, nothing stored. Distinct from single-coin price, sector and TVL APIs — this is the whole market, what's trending, and who's holding.", "upstream_status": null }, "meta": { "timestamp": "2026-06-09T11:39:36.063Z", "request_id": "1d837e97-d425-46cb-a8d2-5b8497cf621b" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/cryptomarket-api OpenAPI spec: https://www.oanor.com/api/cryptomarket-api/openapi.json