API reference · Discover

Service status

Is CoinGraph healthy right now, how fresh is the data, and what does it cost?

FreeMCP tool: get_service_status

Agents should call this before depending on CoinGraph in a live workflow. It reports the pipeline state, the age of every data source, coverage, current prices and the payment details.

Pipeline health and freshness #

GET/v1/status
Request
curl "https://coingraph.ai/api/v1/status"
Response · real, captured 2026-10-06 23:24 UTC · long lists trimmed
{
  "object": "service_status",
  "id": null,
  "as_of": "2026-10-06T23:20:40.828Z",
  "data": {
    "pipeline": "ok",
    "worker_last_beat": "2026-10-06T23:20:26.292Z",
    "coverage": {
      "tokens": 100,
      "tokens_fresh_10m": 100,
      "candle_series": 144,
      "chains": [
        "eth",
        "bsc",
        "… 3 more"
      ],
      "exchanges": [
        "binance",
        "binanceusdm",
        "… 5 more"
      ],
      "sources": [
        "coingecko",
        "ccxt",
        "… 4 more"
      ]
    },
    "feeds": [
      {
        "feed": "ccxt:binance-1m",
        "status": "ok",
        "last_success_sec_ago": 34,
        "every_sec": 60,
        "venues": "Binance"
      },
      {
        "feed": "ccxt:perps-1m",
        "status": "ok",
        "last_success_sec_ago": 34,
        "every_sec": 60,
        "venues": "Binance futures"
      },
      "… 33 more"
    ],
    "freshness": {
      "market_snapshots": {
        "newest": "2026-10-06T23:19:00.000Z",
        "cadence": "CoinGecko · 1 min"
      },
      "cex_ohlcv": {
        "newest": "2026-10-06T23:19:00.000Z",
        "cadence": "Exchanges · 1 min"
      },
      "order_book_snapshots": {
        "newest": "2026-10-06T23:20:00.000Z",
        "cadence": "Demo coins · 5 min"
      },
      "cex_ticker_snapshots": {
        "newest": "2026-10-06T23:20:00.000Z",
        "cadence": "Exchanges · 5 min"
      },
      "funding_rate_snapshots": {
        "newest": "2026-10-06T23:20:00.000Z",
        "cadence": "Futures · 5 min"
      },
      "open_interest_snapshots": {
        "newest": "2026-10-06T23:20:00.000Z",
        "cadence": "Futures · 5 min"
      },
      "futures_sentiment_snapshots": {
        "newest": "2026-10-06T23:15:00.000Z",
        "cadence": "Futures · 5 min"
      },
      "liquidations": {
        "newest": "2026-10-06T23:15:42.850Z",
        "cadence": "OKX · 5 min"
      },
      "category_snapshots": {
        "newest": "2026-10-06T23:20:00.000Z",
        "cadence": "CoinGecko · 5 min"
      },
      "global_snapshots": {
        "newest": "2026-10-06T23:20:00.000Z",
        "cadence": "CoinGecko · 10 min"
      },
      "…": "15 more fields"
    },
    "budgets": {
      "coingecko_credits_remaining": 85978,
      "nownodes_requests_this_month": 2419,
      "nownodes_plan": 100000
    },
    "pricing": {
      "phase": "hackathon",
      "summary": "Reading CoinGraph is free. Prices for Decide calls (evaluate with size, fresh explain, ask) are being finalised and will be paid in ADA via x402; a Token Pass w…",
      "free_rate_limit_per_minute": 60,
      "paid_endpoints": {}
    },
    "payment": {
      "network": "preprod",
      "address": null,
      "facilitator": "https://x402.preprod.dev.ecosyseng.cf-deployments.org",
      "protocol": "x402"
    },
    "docs": {
      "openapi": "https://coingraph.ai/api/v1/openapi.json",
      "llms": "https://coingraph.ai/llms.txt",
      "api_reference": "https://coingraph.ai/docs"
    }
  },
  "sources": []
}

Response #

Inside data:

FieldContents
pipelineok or degraded.
feedsEach data source with its last update and status.
freshnessNewest data per category (market, futures, onchain, context).
coverageTokens, exchanges and chains covered.
pricing / paymentCurrent phase, prices and the Cardano payment details.

Pricing #

Free, always. Without payment a paid call answers 402 with a PAYMENT-REQUIRED header; design partners send Authorization: Bearer cg_… instead. How payment works.