API reference · Decide

Explain a move

Why did this token move? A brief where every statement cites its evidence.

Free · PremiumMCP tool: get_token_brief

When the signal engine sees something unusual it opens an investigation: it gathers market, futures, onchain and news evidence, makes live lookups on the wallets involved, and Claude writes a brief that may only state what the evidence supports. GET returns the latest brief; POST runs a fresh investigation (about 60 seconds).

Latest brief #

GET/v1/explain/{token}

Parameters

  • tokenstring· pathrequired

    Token id (cardano, chainlink, solana), symbol (ADA, LINK, SOL) or contract address.

Chainlink's latest brief

Request
curl "https://coingraph.ai/api/v1/explain/chainlink"
Response · real, captured 2026-10-06 23:24 UTC · long lists trimmed
{
  "object": "brief",
  "id": "49",
  "as_of": "2026-10-06T22:58:20.218Z",
  "data": {
    "token": {
      "id": "chainlink",
      "symbol": "LINK",
      "name": "Chainlink"
    },
    "id": 49,
    "headline": "LINK flat at $13.92 (-0.43%) on thin volume; small onchain exchange outflow",
    "caveats": [
      "The move is small (-0.43%) and within noise, so causes are low confidence",
      "Onchain flow covers Ethereum only, and exchange labeling is partial",
      "… 4 more"
    ],
    "onchain": [
      {
        "text": "On Ethereum there were 932 LINK transfers worth $3.2M. Exchanges took in $221K and sent out $275.1K, a net outflow of $54.1K. That is larger than the typical 15-minute net of $5.1K, but it covers a 2-hour window and is small in absolute terms.",
        "evidence": [
          "E7"
        ]
      },
      {
        "text": "The largest transfers were $70K–$154K each and mostly went between unlabeled wallets. Two were exchange withdrawals: $115.3K from Coinbase at 22:24 and $81.3K from Binance at 21:15, which was then forwarded to another wallet.",
        "evidence": [
          "E8"
        ]
      },
      "… 2 more"
    ],
    "summary": "LINK slipped 0.43% over the two hours, trading between $13.90 and $13.98. It moved about in line with a flat BTC/ETH tape. Binance spot volume was low at 0.4× a typical hour, and derivatives positioning barely changed. No single driver stands out, and the evid…",
    "severity": 1,
    "direction": "neutral",
    "confidence": 0.7,
    "watch_next": [
      "Whether $13.90, the window low, holds if volume comes back to normal levels",
      "Further distribution from wallet 0x4a4aaa01 and where its LINK ends up",
      "… 2 more"
    ],
    "likely_causes": [
      {
        "cause": "Low-volume drift with no clear catalyst. The evidence does not explain the small decline beyond a few modestly sized sell minutes on Binance around 21:40, when liquidity was thin.",
        "evidence": [
          "E2",
          "E1"
        ],
        "confidence": 0.6
      },
      {
        "cause": "LINK roughly tracked a flat broader market (BTC -0.09%, ETH -0.07% in the window), with slightly weaker beta.",
        "evidence": [
          "E15"
        ],
        "confidence": 0.4
      }
    ],
    "what_happened": [
      {
        "text": "LINK fell 0.43% in the window, from about $13.98 to $13.92, within an $13.90–$13.98 range. It is +0.14% over 1h and +0.01% over 24h. Market cap is $10.4B (rank #14).",
        "evidence": [
          "E1"
        ]
      },
      {
        "text": "Binance LINK/USDT traded $335.8K in the last hour, against a typical hour of $758.9K (0.44×). The busiest minute was 21:40 UTC, with $99.1K traded and a -0.129% move, followed by 21:43 at $46.8K and -0.108%. Those two minutes line up with the dip to $13.92 at …",
        "evidence": [
          "E2",
          "E1"
        ]
      }
    ],
    "market_context": [
      {
        "text": "Derivatives look balanced. Binance open interest is $127.3M (+0.2% over 1h, -0.31% over 4h). Funding is about 0.008–0.0097% per 8h across Binance, Bybit and OKX, which is normal. Long/short ratios lean long: 1.63 for all accounts and 2.43 for top traders by po…",
        "evidence": [
          "E3",
          "E4",
          "… 1 more"
        ]
      },
      {
        "text": "The Binance futures order book is even within 2%: $2.9M of bids against $2.9M of asks (ratio 0.97).",
        "evidence": [
          "E6"
        ]
      },
      "… 2 more"
    ],
    "window": {
      "from": "2026-10-06T20:57:30.684Z",
      "to": "2026-10-06T22:57:30.684Z"
    },
    "evidence": [
      {
        "id": "E1",
        "data": {
          "ath": 52.7,
          "low": 13.9,
          "high": 13.98,
          "rank": 14,
          "as_of": "2026-10-06T22:56:00.000Z",
          "price": 13.92,
          "path_15m": [
            {
              "t": "2026-10-06T20:45:00.000Z",
              "price": 13.98
            },
            {
              "t": "2026-10-06T21:00:00.000Z",
              "price": 13.97
            },
            "… 7 more"
          ],
          "market_cap": 10411727193,
          "volume_24h": 267329297,
          "change_1h_pct": 0.14388489208633093,
          "change_7d_pct": null,
          "change_24h_pct": 0.0066,
          "window_return_pct": -0.43
        },
        "kind": "price",
        "source": "coingecko:/coins/markets",
        "summary": "LINK $13.9 now; -0.43% over the window (high $14, low $13.9); 1h +0.14%, 24h +0.01%, 7d n/a; rank #14, market cap $10.4B, 24h volume $267.3M"
      },
      {
        "id": "E2",
        "data": {
          "ratio": 0.4424783473865446,
          "venue": "binance",
          "symbol": "LINK/USDT",
          "volume_1h_usd": 335782.80683,
          "busiest_minutes": [
            {
              "v": "99134.62729",
              "ts": "2026-10-06T21:40:00.000Z",
              "ret": "-0.129",
              "close": "13.929"
            },
            {
              "v": "62419.78621",
              "ts": "2026-10-06T22:26:00.000Z",
              "ret": "-0.036",
              "close": "13.904"
            },
            "… 3 more"
          ],
          "volume_window_usd": 917785.29625,
          "median_hourly_24h_usd": 758868.33517
        },
        "kind": "spot_volume",
        "source": "binance:klines:1m",
        "summary": "binance LINK/USDT: $335.8K traded in the last hour vs a typical hour of $758.9K (0.4×); busiest minutes: 21:40 $99.1K (-0.129%), 22:26 $62.4K (-0.036%), 21:13 $49.7K (-0.036%), 21:43 $46.8K (-0.108%), 21:39 $38.6K (+0.072%)"
      },
      "… 16 more"
    ],
    "model": "claude-opus-5-5",
    "score": null,
    "verify_url": "https://coingraph.ai/api/v1/verify/49"
  },
  "sources": [
    {
      "provider": "coingecko",
      "endpoint": "coingecko:/coins/markets",
      "as_of": null
    },
    {
      "provider": "binance",
      "endpoint": "binance:klines:1m",
      "as_of": null
    },
    "… 13 more"
  ]
}

A specific past brief #

GET/v1/explain/{token}/{id}

Parameters

  • tokenstring· pathrequired

    Token id (cardano, chainlink, solana), symbol (ADA, LINK, SOL) or contract address.
  • idinteger· pathrequired

    Brief number.
Request
curl "https://coingraph.ai/api/v1/explain/chainlink/46"

Run a fresh investigation #

POST/v1/explain

Parameters

  • tokenstring· bodyrequired

    Token id (cardano, chainlink, solana), symbol (ADA, LINK, SOL) or contract address.
  • hoursnumber (1–24)· bodyoptionaldefault 2

    How far back to investigate.
Request
curl -X POST "https://coingraph.ai/api/v1/explain" \
  -H "content-type: application/json" \
  -d '{"token":"chainlink","hours":2}'

Response #

Inside data:

FieldContents
headline, summaryOne line and one paragraph.
direction, severity, confidencebullish / bearish / neutral, 1 to 3, 0 to 1.
what_happened, likely_causes, onchain, market_contextClaims, each citing evidence ids such as e3 or e7.
watch_next, caveatsWhat would confirm or contradict it, and what is uncertain.
evidence[]Every item: id, kind, source, summary and the raw data.

Pricing #

GET is free. POST is Premium: 5 tADA per call via x402 (mainnet $0.05). Without payment a paid call answers 402 with a PAYMENT-REQUIRED header; design partners send Authorization: Bearer cg_… instead. How payment works.