DataMCP tool: get_token_snapshot

One call replaces a dozen integrations. The state is split into sections; ask only for the ones you need with sections. Every section carries its own as_of and sources, and anything CoinGraph cannot measure is the string "unassessed".

Current state of a token #

GET/v1/state/{token}

Parameters

tokenstring· pathrequired
Token id (cardano, chainlink, solana), symbol (ADA, LINK, SOL) or contract address.
sectionsstring· queryoptional
Comma list: identity, market, liquidity, derivatives, onchain, supply, security, context, signals, brief. Default: all.

Chainlink: market, liquidity and contract security

Request

curl "https://coingraph.ai/api/v1/state/chainlink?sections=market,liquidity,security"

Response · real, captured 2026-10-06 23:24 UTC · long lists trimmed

{
  "object": "state",
  "id": "st_897d997cb619b50fd57a",
  "as_of": "2026-10-06T23:20:00.000Z",
  "data": {
    "token": {
      "id": "chainlink",
      "symbol": "LINK",
      "name": "Chainlink",
      "rank": 14
    },
    "market": {
      "price_usd": 13.96,
      "market_cap_usd": 10438408076,
      "fully_diluted_valuation_usd": 13953226158,
      "volume_24h_usd": 263808735,
      "rank": 14,
      "change_pct": {
        "15m": 0.14,
        "1h": 0.29,
        "4h": 0.22,
        "24h": 0.74,
        "7d": -5.2107,
        "30d": 8.1012,
        "200d": 40.1246,
        "1y": -40.4316
      },
      "high_24h_usd": 14.11,
      "low_24h_usd": 13.72,
      "ath_usd": 52.7,
      "ath_date": "2021-05-09T16:13:57.000Z",
      "from_ath_pct": -73.52,
      "atl_usd": 0.148183,
      "from_atl_pct": 9318.21,
      "volatility_24h_pct": 2.45,
      "volume_to_market_cap": 0.0253,
      "as_of": "2026-10-06T23:19:00.000Z",
      "…": "1 more fields"
    },
    "liquidity": {
      "order_books": [
        {
          "venue": "binance",
          "symbol": "LINK/USDT",
          "best_bid": 13.968,
          "best_ask": 13.969,
          "spread_pct": 0.007158964813683974,
          "depth_2pct_bid_usd": 440756,
          "depth_2pct_ask_usd": 413229,
          "as_of": "2026-10-06T23:20:00.000Z"
        },
        {
          "venue": "binanceusdm",
          "symbol": "LINK/USDT:USDT",
          "best_bid": 13.961,
          "best_ask": 13.962,
          "spread_pct": 0.0071625541668119165,
          "depth_2pct_bid_usd": 3008840,
          "depth_2pct_ask_usd": 2852590,
          "as_of": "2026-10-06T23:20:00.000Z"
        }
      ],
      "depth_2pct_total_usd": {
        "bid": 3449590,
        "ask": 3265820,
        "bid_ask_ratio": 1.06
      },
      "venues_tracked": [
        {
          "venue": "binance",
          "symbol": "LINK/USDT",
          "last": 13.963,
          "bid": 13.963,
          "ask": 13.964,
          "volume_24h_quote": 16509600
        },
        {
          "venue": "bybit",
          "symbol": "LINK/USDT",
          "last": 13.965,
          "bid": 13.962,
          "ask": 13.964,
          "volume_24h_quote": 16781200
        },
        "… 4 more"
      ],
      "price_dispersion_pct": 0.045,
      "exchanges": {
        "count": 25,
        "trusted_count": 0,
        "volume_24h_usd": 238458000,
        "median_spread_pct": 0.017,
        "cost_to_move_2pct_usd": {
          "up": 16773400,
          "down": 14417600
        },
        "top": [
          {
            "exchange": "Binance",
            "pair": "LINK/USDT",
            "volume_24h_usd": 24386800,
            "spread_pct": 0.017138,
            "trust": null,
            "anomaly": false,
            "stale": false
          },
          {
            "exchange": "BitDelta",
            "pair": "LINK/USDT",
            "volume_24h_usd": 24349000,
            "spread_pct": 0.42735,
            "trust": null,
            "anomaly": false,
            "stale": false
          },
          "… 8 more"
        ]
      },
      "dex_pools": [
        {
          "network": "eth",
          "dex": "uniswap_v3",
          "pool": "AAVE / LINK 0.3%",
          "address": "0x14243ea6bb3d64c8d54a1f47b077e23394d6528a",
          "liquidity_usd": 359445,
          "volume_24h_usd": 69298,
          "buys_1h": 0,
          "sells_1h": 0,
          "buyers_1h": 0,
          "sellers_1h": 0,
          "price_usd": 14.0301417412315
        },
        {
          "network": "eth",
          "dex": "uniswap-v4-ethereum",
          "pool": "1INCH / LINK 1%",
          "address": "0x17bc62f62658a42755e4f36a20f32dfc1a88e2b75ff714640a22577802f22958",
          "liquidity_usd": 803280,
          "volume_24h_usd": 34187.1,
          "buys_1h": 0,
          "sells_1h": 0,
          "buyers_1h": 0,
          "sellers_1h": 0,
          "price_usd": 14.0134883358984
        },
        "… 18 more"
      ],
      "as_of": "2026-10-06T23:20:00.000Z",
      "sources": [
        {
          "provider": "ccxt",
          "endpoint": "fetchOrderBook",
          "as_of": "2026-10-06T23:20:00.000Z"
        },
        {
          "provider": "ccxt",
          "endpoint": "fetchTickers",
          "as_of": "2026-10-06T23:20:00.000Z"
        },
        "… 2 more"
      ]
    },
    "security": {
      "risk_level": "low",
      "rated_on": "eth (home chain)",
      "contracts": [
        {
          "chain": "bsc",
          "home_chain": false,
          "address": "0xf8a0bf9cf54bb92f17374d9e9a321e6a111a51bd",
          "risk_level": "medium",
          "flags": [
            "Supply can be increased (mint authority)",
            "Issuer controls are expected for this kind of asset (stablecoin or tokenized fund)"
          ],
          "honeypot": false,
          "buy_tax_pct": null,
          "sell_tax_pct": null,
          "mintable": true,
          "upgradeable": false,
          "blacklist": false,
          "pausable": false,
          "hidden_owner": false,
          "owner_can_change_balances": false,
          "verified_source": true,
          "freezable": null,
          "…": "5 more fields"
        },
        {
          "chain": "eth",
          "home_chain": true,
          "address": "0x514910771af9ca656af840dff83e8264ecf986ca",
          "risk_level": "low",
          "flags": [],
          "honeypot": false,
          "buy_tax_pct": 0,
          "sell_tax_pct": 0,
          "mintable": false,
          "upgradeable": false,
          "blacklist": false,
          "pausable": false,
          "hidden_owner": false,
          "owner_can_change_balances": false,
          "verified_source": true,
          "freezable": null,
          "…": "5 more fields"
        },
        "… 1 more"
      ],
      "as_of": "2026-10-06T20:30:00.000Z",
      "sources": [
        {
          "provider": "goplus",
          "endpoint": "/token_security",
          "as_of": "2026-10-06T20:30:00.000Z"
        }
      ]
    }
  },
  "sources": [
    {
      "provider": "coingecko",
      "endpoint": "/coins/markets",
      "as_of": "2026-10-06T23:19:00.000Z"
    },
    {
      "provider": "ccxt",
      "endpoint": "fetchOrderBook",
      "as_of": "2026-10-06T23:20:00.000Z"
    },
    "… 4 more"
  ]
}

Response #

Inside data:

Field	Contents
`identity`	Name, symbol, chains and contracts, categories, links, where it trades.
`market`	Price, market cap, FDV, volume, changes from 15 minutes to 1 year, ATH/ATL, volatility, beta to BTC.
`liquidity`	Order-book depth within 2% and spread per exchange, cost to move the price ±2%, DEX pools, price dispersion.
`derivatives`	Open interest and its change, funding per venue, long/short ratios, taker flow, liquidations, basis, leverage ratio.
`onchain`	Exchange inflow, outflow and net flow, large transfers tagged with exchange names, exchange reserves, holder concentration, fees.
`supply`	Circulating, total and max supply, FDV ratio, exchange-held and top-holder share. `unlocks` is `"unassessed"`.
`security`	Contract risk from GoPlus on the home chain: honeypot test, mint, pause, blacklist and owner powers, taxes, upgradeability.
`context`	News, protocol TVL, developer activity, community, trending rank, Fear & Greed.
`signals / brief`	Open signals, and the latest brief's headline (full text via Explain).

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.

Token state

Current state of a token #

Response #

Pricing #