API reference · Decide
Explain a move
Why did this token move? A brief where every statement cites its evidence.
get_token_briefWhen 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 #
/v1/explain/{token}Parameters
tokenstring· pathrequiredToken id (cardano,chainlink,solana), symbol (ADA,LINK,SOL) or contract address.
Chainlink's latest brief
curl "https://coingraph.ai/api/v1/explain/chainlink"{
"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 #
/v1/explain/{token}/{id}Parameters
tokenstring· pathrequiredToken id (cardano,chainlink,solana), symbol (ADA,LINK,SOL) or contract address.idinteger· pathrequiredBrief number.
curl "https://coingraph.ai/api/v1/explain/chainlink/46"Run a fresh investigation #
/v1/explainParameters
tokenstring· bodyrequiredToken id (cardano,chainlink,solana), symbol (ADA,LINK,SOL) or contract address.hoursnumber (1–24)· bodyoptionaldefault 2How far back to investigate.
curl -X POST "https://coingraph.ai/api/v1/explain" \
-H "content-type: application/json" \
-d '{"token":"chainlink","hours":2}'Response #
Inside data:
| Field | Contents |
|---|---|
headline, summary | One line and one paragraph. |
direction, severity, confidence | bullish / bearish / neutral, 1 to 3, 0 to 1. |
what_happened, likely_causes, onchain, market_context | Claims, each citing evidence ids such as e3 or e7. |
watch_next, caveats | What 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.