DataMCP tool: get_token_timeline

Series are time-ordered points for charts and models; events are discrete things that happened, each with a timestamp. Defaults: 24 hours of events and 14 days of series.

Series and events #

GET/v1/history/{token}

Parameters

tokenstring· pathrequired
Token id (cardano, chainlink, solana), symbol (ADA, LINK, SOL) or contract address.
sinceISO-8601· queryoptional
Start time, e.g. 2026-10-06T00:00:00Z.
seriesstring· queryoptional
Comma list: price, candles, open_interest, funding, long_short, exchange_net_flow, reserves, tvl.
resolutionstring· queryoptional
Bucket width: 15m, 1h, 6h, raw, or auto (default: 15 min up to 2 days, hourly up to 30 days). The answer says which it used.

Solana: price and funding for the last 6 hours

Request

curl "https://coingraph.ai/api/v1/history/solana?series=price,funding&since=2026-10-06T17:20:43.571Z"

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

{
  "object": "history",
  "id": "hs_9560291113131df7470b",
  "as_of": "2026-10-06T23:20:44.128Z",
  "data": {
    "token": {
      "id": "solana",
      "symbol": "SOL",
      "name": "Solana"
    },
    "window": {
      "series_from": "2026-10-06T17:20:43.571Z",
      "events_from": "2026-10-06T17:20:43.571Z",
      "to": "2026-10-06T23:20:44.128Z"
    },
    "series": {
      "funding": {
        "columns": [
          "t",
          "funding_rate_pct"
        ],
        "by_venue": {
          "binanceusdm": [
            [
              "2026-10-06T17:25:00.000Z",
              0.00803
            ],
            [
              "2026-10-06T17:30:00.000Z",
              0.007883000000000001
            ],
            [
              "2026-10-06T17:35:00.000Z",
              0.007782
            ],
            "… 70 more"
          ],
          "okx": [
            [
              "2026-10-06T17:25:00.000Z",
              0.0016692566662299998
            ],
            [
              "2026-10-06T17:30:00.000Z",
              0.00177200147515
            ],
            [
              "2026-10-06T17:35:00.000Z",
              0.00189070815996
            ],
            "… 70 more"
          ],
          "bybit": [
            [
              "2026-10-06T17:25:00.000Z",
              -0.009711
            ],
            [
              "2026-10-06T17:30:00.000Z",
              -0.008592
            ],
            [
              "2026-10-06T17:35:00.000Z",
              -0.007750999999999999
            ],
            "… 70 more"
          ]
        }
      },
      "price": {
        "step": "5m (recent) / 1h (older)",
        "points": [
          [
            "2026-09-06T18:00:00.000Z",
            106.18709197035312,
            62166699012.29705,
            "… 1 more"
          ],
          [
            "2026-09-06T19:00:00.000Z",
            105.98261892858817,
            62046987135.01789,
            "… 1 more"
          ],
          [
            "2026-09-06T20:00:00.000Z",
            105.46896163982326,
            61746267628.523415,
            "… 1 more"
          ],
          "… 787 more"
        ],
        "columns": [
          "t",
          "price_usd",
          "market_cap_usd",
          "… 1 more"
        ]
      }
    },
    "events": {
      "transfers": [],
      "liquidations": [
        {
          "at": "2026-10-06T22:09:09.034Z",
          "venue": "okx",
          "side": "short",
          "price": 121.42,
          "quantity": 21.66,
          "usd": 2629.9572
        },
        {
          "at": "2026-10-06T22:09:03.483Z",
          "venue": "okx",
          "side": "short",
          "price": 121.38,
          "quantity": 5.02,
          "usd": 609.3276
        },
        {
          "at": "2026-10-06T22:04:15.394Z",
          "venue": "okx",
          "side": "short",
          "price": 121.37,
          "quantity": 12,
          "usd": 1456.44
        },
        "… 13 more"
      ],
      "signals": [],
      "headlines": [],
      "briefs": []
    }
  },
  "sources": [
    {
      "provider": "ccxt",
      "endpoint": "fetchFundingRates",
      "as_of": null
    },
    {
      "provider": "nownodes",
      "endpoint": "onchain_transfers",
      "as_of": null
    },
    {
      "provider": "okx+binance",
      "endpoint": "liquidations",
      "as_of": null
    },
    "… 3 more"
  ]
}

Response #

Inside data:

Field	Contents
`series`	price (5-minute for 14 days, hourly to 30 days), market cap, volume, 1-minute candles, open interest, funding, long/short, exchange net flow (15-minute), reserves (hourly), TVL.
`events`	Large transfers (from, to, exchange tags, tx hash), liquidations, signals, headlines and briefs.

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 history

Series and events #

Response #

Pricing #