API reference · Decide

Ask or check a claim

A cited answer to a question, or a verdict on a claim.

PremiumMCP tool: ask_about_token

Send exactly one of question or claim. A question gets a plain answer with key points and their evidence. A claim gets supported, contradicted or unknown. Takes 20 to 40 seconds.

Question or claim #

POST/v1/ask

Parameters

  • tokenstring· bodyrequired

    Token id (cardano, chainlink, solana), symbol (ADA, LINK, SOL) or contract address.
  • questionstring (3–500)· bodyoptional

    A question, e.g. “Are large holders moving ADA onto exchanges today?”
  • claimstring (3–500)· bodyoptional

    A statement to test, e.g. “SOL futures are crowded long.”

A question about Cardano

Request
curl -X POST "https://coingraph.ai/api/v1/ask" \
  -H "content-type: application/json" \
  -d '{"token":"cardano","question":"Are large holders moving ADA onto exchanges today?"}'
Response · real, captured 2026-10-06 23:24 UTC · long lists trimmed
{
  "object": "answer",
  "id": "ans_1ce0735d67b2214f24b9",
  "as_of": "2026-10-06T23:21:14.697Z",
  "data": {
    "token": {
      "id": "cardano",
      "symbol": "ADA",
      "name": "Cardano"
    },
    "mode": "question",
    "input": "Are large holders moving ADA onto exchanges today?",
    "answer": "The evidence doesn't show large holders moving ADA onto exchanges in the last 4 hours, but it can't rule it out either. Treat the answer as unknown, not as a confirmed \"no.\" The onchain tracker logged 44 ADA transfers worth $32.1M with $0 onto exchanges and $0 off them (E7). However, its typical 15-minute exchange net …",
    "confidence": 0.5,
    "caveats": [],
    "key_points": [
      {
        "text": "The evidence doesn't show large holders moving ADA onto exchanges in the last 4 hours, but it can't rule it out either.",
        "evidence": []
      },
      {
        "text": "Treat the answer as unknown, not as a confirmed \"no.\" The onchain tracker logged 44 ADA transfers worth $32.1M with $0 onto exchanges and $0 off them (E7).",
        "evidence": []
      },
      {
        "text": "However, its typical 15-minute exchange net flow over 7 days is also $0, and none of the 12 largest transfers has a known owner (all marked \"other\") (E8).",
        "evidence": []
      },
      "… 1 more"
    ],
    "evidence": [
      {
        "id": "E1",
        "source": "coingecko:/coins/markets",
        "kind": "price",
        "summary": "ADA $0.3 now; -0.83% over the window (high $0.3, low $0.3); 1h -0.02%, 24h -1%, 7d n/a; rank #17, market cap $10.1B, 24h volume $677M",
        "data": {
          "price": 0.267999,
          "window_return_pct": -0.83,
          "high": 0.27116,
          "low": 0.267561,
          "change_1h_pct": -0.023874984611826324,
          "change_24h_pct": -0.99619,
          "change_7d_pct": null,
          "rank": 17,
          "market_cap": 10061624329,
          "volume_24h": 677047662,
          "ath": 3.09,
          "as_of": "2026-10-06T23:20:00.000Z",
          "path_15m": [
            {
              "t": "2026-10-06T19:15:00.000Z",
              "price": 0.270249
            },
            {
              "t": "2026-10-06T19:30:00.000Z",
              "price": 0.270195
            },
            {
              "t": "2026-10-06T19:45:00.000Z",
              "price": 0.270684
            },
            "… 14 more"
          ]
        }
      },
      {
        "id": "E2",
        "source": "binance:klines:1m",
        "kind": "spot_volume",
        "summary": "binance ADA/USDT: $1M traded in the last hour vs a typical hour of $1.9M (0.5×); busiest minutes: 21:50 $185.6K (-0.186%), 21:28 $129.5K (-0.222%), 20:04 $119.8K (-0.148%), 20:02 $107.1K (-0.074%), 22:10 $106.7K (-0.074%)",
        "data": {
          "venue": "binance",
          "symbol": "ADA/USDT",
          "volume_1h_usd": 1008642.43244,
          "median_hourly_24h_usd": 1941970.13219,
          "ratio": 0.5193913210717268,
          "volume_window_usd": 4429560.68058,
          "busiest_minutes": [
            {
              "ts": "2026-10-06T21:50:00.000Z",
              "close": "0.2681",
              "v": "185608.4233",
              "ret": "-0.186"
            },
            {
              "ts": "2026-10-06T21:28:00.000Z",
              "close": "0.2695",
              "v": "129548.1525",
              "ret": "-0.222"
            },
            {
              "ts": "2026-10-06T20:04:00.000Z",
              "close": "0.2704",
              "v": "119797.91122",
              "ret": "-0.148"
            },
            "… 2 more"
          ]
        }
      },
      {
        "id": "E3",
        "source": "binanceusdm:openInterestHist:5m",
        "kind": "open_interest",
        "summary": "Binance futures open interest $122.1M: -0.07% vs 1h ago, -1.72% vs 4h ago",
        "data": {
          "open_interest_usd": 122108922.881297,
          "change_1h_pct": -0.07,
          "change_4h_pct": -1.72,
          "as_of": "2026-10-06T23:20:00.000Z"
        }
      },
      "… 9 more"
    ],
    "model": "claude-opus-5-5",
    "hash": "58591d15fec680aab8e65bc14f55bdd93cf0b925d0ffe8aa23f62c7906dc98a7",
    "verify_url": "https://coingraph.ai/api/v1/verify/ans_1ce0735d67b2214f24b9"
  },
  "sources": [
    {
      "provider": "coingecko",
      "endpoint": "coingecko:/coins/markets",
      "as_of": null
    },
    {
      "provider": "binance",
      "endpoint": "binance:klines:1m",
      "as_of": null
    },
    {
      "provider": "binanceusdm",
      "endpoint": "binanceusdm:openInterestHist:5m",
      "as_of": null
    },
    "… 9 more"
  ]
}

Response #

Inside data:

FieldContents
answer / verdictPlain-text answer, or supported / contradicted / unknown.
key_points / reasoningEach with the evidence it rests on.
confidence0 to 1.
evidence[], id, verify_urlThe inputs, and the proof.

Checking a claim #

“SOL futures are heavily crowded on the long side right now”

Request
curl -X POST "https://coingraph.ai/api/v1/ask" \
  -H "content-type: application/json" \
  -d '{"token":"solana","claim":"SOL futures are heavily crowded on the long side right now"}'
Response · real, captured 2026-10-06 23:24 UTC · long lists trimmed
{
  "object": "answer",
  "id": "ans_d7ff448e5cb3972aab70",
  "as_of": "2026-10-06T23:21:30.634Z",
  "data": {
    "token": {
      "id": "solana",
      "symbol": "SOL",
      "name": "Solana"
    },
    "mode": "claim",
    "input": "SOL futures are heavily crowded on the long side right now",
    "verdict": "contradicted",
    "reasoning": [
      {
        "text": "Funding is at the normal baseline on all three venues: 0.0100% per 8h on Binance, Bybit and OKX. The source itself says about 0.01% is normal. When longs are heavily crowded, they usually pay a clearly higher funding rate. That isn't happening here.",
        "evidence": [
          "E4"
        ]
      },
      {
        "text": "Open interest is flat to slightly down: about $1.0B, -0.29% vs 1h ago and +0.66% vs 4h ago. No new leverage is piling in, long or short.",
        "evidence": [
          "E3"
        ]
      },
      {
        "text": "Forced liquidations were tiny and mostly hit shorts: 9 liquidations worth $51.8K, $38K shorts vs $13.9K longs. Nothing points to an overloaded long side being flushed.",
        "evidence": [
          "E6"
        ]
      },
      "… 2 more"
    ],
    "confidence": 0.55,
    "caveats": [
      "The long/short ratios (1.62 all accounts, 2.19 top positions) clearly lean long. There's no history in the evidence to tell whether these levels are unusually high for SOL, so a milder claim like 'leaning long' would be supported.",
      "Taker buy/sell data is missing (null), so current aggressive buying vs selling can't be checked.",
      "Positioning ratios are from Binance only. Funding covers three venues, and liquidations cover OKX and Binance.",
      "… 1 more"
    ],
    "evidence": [
      {
        "id": "E1",
        "source": "coingecko:/coins/markets",
        "kind": "price",
        "summary": "SOL $120.5 now; +0.06% over the window (high $121.3, low $120.5); 1h -0.59%, 24h -0.11%, 7d n/a; rank #7, market cap $70.9B, 24h volume $2.5B",
        "data": {
          "price": 120.54,
          "window_return_pct": 0.06,
          "high": 121.33,
          "low": 120.47,
          "change_1h_pct": -0.5937654626422563,
          "change_24h_pct": -0.10719,
          "change_7d_pct": null,
          "rank": 7,
          "market_cap": 70932190287,
          "volume_24h": 2461694229,
          "ath": 293.31,
          "as_of": "2026-10-06T23:20:00.000Z",
          "path_15m": [
            {
              "t": "2026-10-06T19:15:00.000Z",
              "price": 120.47
            },
            {
              "t": "2026-10-06T19:30:00.000Z",
              "price": 120.49
            },
            {
              "t": "2026-10-06T19:45:00.000Z",
              "price": 120.53
            },
            "… 14 more"
          ]
        }
      },
      {
        "id": "E2",
        "source": "binance:klines:1m",
        "kind": "spot_volume",
        "summary": "binance SOL/USDT: $2.7M traded in the last hour vs a typical hour of $5.2M (0.5×); busiest minutes: 21:38 $852.9K (-0.074%), 21:37 $666.8K (-0.074%), 22:04 $603.7K (+0.074%), 21:42 $460.2K (+0.008%), 20:39 $413.3K (+0.116%)",
        "data": {
          "venue": "binance",
          "symbol": "SOL/USDT",
          "volume_1h_usd": 2733543.74107,
          "median_hourly_24h_usd": 5176442.26207,
          "ratio": 0.5280738396523498,
          "volume_window_usd": 17400520.79405,
          "busiest_minutes": [
            {
              "ts": "2026-10-06T21:38:00.000Z",
              "close": "120.99",
              "v": "852880.31294",
              "ret": "-0.074"
            },
            {
              "ts": "2026-10-06T21:37:00.000Z",
              "close": "121.09",
              "v": "666803.46785",
              "ret": "-0.074"
            },
            {
              "ts": "2026-10-06T22:04:00.000Z",
              "close": "121.28",
              "v": "603740.74749",
              "ret": "0.074"
            },
            "… 2 more"
          ]
        }
      },
      {
        "id": "E3",
        "source": "binanceusdm:openInterestHist:5m",
        "kind": "open_interest",
        "summary": "Binance futures open interest $1B: -0.29% vs 1h ago, +0.66% vs 4h ago",
        "data": {
          "open_interest_usd": 1003154961.3701798,
          "change_1h_pct": -0.29,
          "change_4h_pct": 0.66,
          "as_of": "2026-10-06T23:15:00.000Z"
        }
      },
      "… 9 more"
    ],
    "model": "claude-opus-5-5",
    "hash": "93e4c1895e4048d6557e8e93d02c13802611cb16b543f4d7c64b492286d68818",
    "verify_url": "https://coingraph.ai/api/v1/verify/ans_d7ff448e5cb3972aab70"
  },
  "sources": [
    {
      "provider": "coingecko",
      "endpoint": "coingecko:/coins/markets",
      "as_of": null
    },
    {
      "provider": "binance",
      "endpoint": "binance:klines:1m",
      "as_of": null
    },
    {
      "provider": "binanceusdm",
      "endpoint": "binanceusdm:openInterestHist:5m",
      "as_of": null
    },
    "… 9 more"
  ]
}

Pricing #

Premium tier: 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.