Core concepts

Token ids #

CoinGraph uses CoinGecko ids. Symbols and contract addresses work too, wherever a token is expected:

The 100 largest tokens are tracked continuously. Use search to find any of 21,000+ coins and see whether it is tracked.

The response envelope #

Every API response, and every MCP tool result, has the same shape:

{
  "object": "evaluation",
  "id": "eval_cf5e78e040b79780a06e",
  "as_of": "2026-10-06T22:36:20.000Z",
  "data": {
    "…": "the answer"
  },
  "sources": [
    {
      "provider": "coingecko",
      "endpoint": "/coins/markets",
      "as_of": "2026-10-06T22:36:00.000Z"
    },
    {
      "provider": "nownodes",
      "endpoint": "eth:eth_getLogs",
      "as_of": "2026-10-06T22:30:00.000Z"
    }
  ]
}

Unassessed, never guessed #

When CoinGraph cannot measure something, the value is the string "unassessed". For example, a token with no perpetual futures market has an unassessed derivatives section, and token unlock schedules are unassessed for every token because there is no free, reliable source. Your code should treat unassessed as “unknown”, not as zero or as safe.

Verdicts #

Checks #

A check rates seven dimensions and the worst rating drives the verdict:

Agents #

Agents answer in their own words, such as ALLOW REDUCE BLOCK for Trade Gatekeeper. Each agent page lists its verdicts.

Ids and proofs #

Pass any id to Verify, or open /proof/{id} in a browser. See Proofs & track record.

Errors #

{
  "error": {
    "code": "token_not_found",
    "message": "No tracked token matches \"not-a-coin\". Try GET /v1/tokens?q=…"
  }
}

Limits #