---
title: "Everything we know about a token right now"
method: GET
path: "/state/{token}"
tags: ["Understand"]
---

# Everything we know about a token right now

`GET /state/{token}`

## Request

- Base URL: `https://coingraph.ai/api/v1`
- URL: `https://coingraph.ai/api/v1/state/{token}`
- Auth: none declared

Sections: identity, market, liquidity, derivatives, onchain, supply, security (contract risk via GoPlus), context, signals, brief. Each section carries its own sources and as_of. Free.

## Path parameters

- `token` string, required

## Query parameters

- `sections` string

## Response `200`

Unified token state

- object
  - `object` 'state', required
  - `id` string, nullable
  - `as_of` string, date-time, required
  - `data` State, required: token + one key per section; each section has as_of and sources; unmeasured values are the string "unassessed".
  - `sources` Source[], required
    - `provider` string
    - `endpoint` string
    - `as_of` string, date-time, nullable

## Other responses

- `400`: Error
- `404`: Error
- `429`: Error

---

[API](https://skmtc.dev/coingraph/apis/coingraph-api.md) · [All operations](https://skmtc.dev/coingraph/apis/coingraph-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coingraph/apis/coingraph-api/revisions/55d33f7ec7a8?raw)