CoinGraphDocs

API reference · Understand

Market overview

The whole crypto market at a glance.

DataMCP tool: get_market_overview

Use this for context before acting on a single token: is the whole market risk-on, are stablecoins moving onto exchanges, which sectors lead?

Market-wide state #

GET/v1/market

Parameters

  • sectionsstring· queryoptional

    Comma list: overview, sectors, breadth, sentiment, flows, chains, venues, rankings, events, pulse. Default: all.

Overview, breadth and sentiment

Request
curl "https://coingraph.ai/api/v1/market?sections=overview,breadth,sentiment"
Response · real, captured 2026-10-06 23:24 UTC · long lists trimmed
{
  "object": "market",
  "id": "mk_b414f56cbf685a73cb0f",
  "as_of": "2026-10-06T23:20:45.388Z",
  "data": {
    "overview": {
      "total_market_cap_usd": 2922440000000,
      "total_volume_24h_usd": 68434300000000,
      "market_cap_change_24h_pct": -3.23,
      "volume_change_24h_pct": 75415.71,
      "btc_dominance_pct": 58.7,
      "eth_dominance_pct": 11.26,
      "dominance": {
        "bnb": 3.54,
        "btc": 58.7,
        "eth": 11.26,
        "sol": 2.43,
        "trx": 1.09,
        "xrp": 3.23,
        "usdc": 2.53,
        "usdt": 6.29,
        "steth": 0.9,
        "figr_heloc": 0.84
      },
      "active_cryptocurrencies": 21954,
      "markets": 1507,
      "as_of": "2026-10-06T23:20:00.000Z",
      "sources": [
        {
          "provider": "coingecko",
          "endpoint": "/global",
          "as_of": "2026-10-06T23:20:00.000Z"
        }
      ]
    },
    "breadth": {
      "coins": 83,
      "up_1h": 42,
      "down_1h": 26,
      "up_1h_pct": 50.6,
      "up_24h": 30,
      "down_24h": 51,
      "up_24h_pct": 36.1,
      "rising_open_interest": 42,
      "rising_open_interest_pct": 65.6,
      "as_of": "2026-10-06T23:20:00.000Z",
      "sources": [
        {
          "provider": "coingecko",
          "endpoint": "/coins/markets",
          "as_of": "2026-10-06T23:20:00.000Z"
        },
        {
          "provider": "binanceusdm",
          "endpoint": "openInterestHist",
          "as_of": null
        }
      ]
    },
    "sentiment": {
      "fear_greed": {
        "value": 73,
        "label": "Greed",
        "day": "2026-10-06T00:00:00.000Z",
        "history_30d": [
          [
            "2026-10-06T00:00:00.000Z",
            73
          ],
          [
            "2026-10-05T00:00:00.000Z",
            70
          ],
          "… 28 more"
        ]
      },
      "trending": [
        {
          "position": 1,
          "id": "zignaly",
          "symbol": "ZIG",
          "name": "ZIG Finance",
          "rank": 326,
          "change_24h_pct": 5.74
        },
        {
          "position": 2,
          "id": "orca",
          "symbol": "ORCA",
          "name": "Orca",
          "rank": 194,
          "change_24h_pct": 34.26
        },
        "… 13 more"
      ],
      "as_of": "2026-10-06T23:20:00.000Z",
      "sources": [
        {
          "provider": "alternative.me",
          "endpoint": "/fng",
          "as_of": null
        },
        {
          "provider": "coingecko",
          "endpoint": "/search/trending",
          "as_of": "2026-10-06T23:20:00.000Z"
        }
      ]
    }
  },
  "sources": [
    {
      "provider": "coingecko",
      "endpoint": "/global",
      "as_of": "2026-10-06T23:20:00.000Z"
    },
    {
      "provider": "coingecko",
      "endpoint": "/coins/markets",
      "as_of": "2026-10-06T23:20:00.000Z"
    },
    "… 3 more"
  ]
}

Response #

Inside data:

FieldContents
overviewTotal market cap and volume, 24h change, BTC and ETH dominance.
sectorsMarket cap and change per category.
breadthShare of the top 100 up or down over 1h and 24h.
sentimentFear & Greed with history, trending searches.
flowsStablecoins to and from exchanges, biggest inflows and outflows.
chains / venuesNetwork fees, Bitcoin mempool, exchange outages.
rankings / events / pulseTop movers, volume spikes, whale activity; the last 24h of events; the hourly written market brief.

Pricing #

Data tier: 25 free calls a day per caller, then 2 tADA per call via x402 (mainnet $0.01). Without payment a paid call answers 402 with a PAYMENT-REQUIRED header; design partners send Authorization: Bearer cg_… instead. How payment works.