API reference · Discover
Service status
Is CoinGraph healthy right now, how fresh is the data, and what does it cost?
FreeMCP tool:
get_service_statusAgents 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/statusRequest
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:
| Field | Contents |
|---|---|
pipeline | ok or degraded. |
feeds | Each data source with its last update and status. |
freshness | Newest data per category (market, futures, onchain, context). |
coverage | Tokens, exchanges and chains covered. |
pricing / payment | Current 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.