API reference
API reference
A JSON API over HTTPS. Every response is sourced and timed, and anything that goes on the record carries an id you can prove.
Base URL #
https://coingraph.ai/api/v1
No key is needed to start. The base URL already includes /v1; paths in this reference are written as /v1/… so that they read like the OpenAPI spec.
curl "https://coingraph.ai/api/v1/state/cardano?sections=market"Requests and responses #
- Send JSON bodies with
content-type: application/json. Bodies are limited to 16 KB. - Tokens can be given as a CoinGecko id (
cardano), a symbol (LINK) or a contract address. - Every response is
{ object, id, as_of, data, sources }. See Core concepts. - CORS is open, so browsers can call the API directly.
Endpoints #
Discover · Find what CoinGraph covers and whether it is healthy.
| Endpoint | What it answers | Tier |
|---|---|---|
| List & search tokens | The 100 tokens CoinGraph tracks in depth, or a search across 21,000+ coins. GET /v1/tokens | Free |
| Service status | Is CoinGraph healthy right now, how fresh is the data, and what does it cost? GET /v1/status | Free |
Understand · Everything CoinGraph knows, as data.
| Endpoint | What it answers | Tier |
|---|---|---|
| Token state | Everything CoinGraph knows about a token right now, in one object. GET /v1/state/{token} | Data |
| Token history | What happened to a token over time: charts and events. GET /v1/history/{token} | Data |
| Market overview | The whole crypto market at a glance. GET /v1/market | Data |
| Inspect an address | Who is behind an address, read live from the chain. GET /v1/inspect/{chain}/{address} | Premium |
Decide · Ask CoinGraph to think. Creates objects with ids that go on the public record.
| Endpoint | What it answers | Tier |
|---|---|---|
| Evaluate a token | Should you act on this token right now? Proceed, caution or avoid, with reasons. GET /v1/evaluate/{token} · POST /v1/evaluate | Free · Premium |
| Explain a move | Why did this token move? A brief where every statement cites its evidence. GET /v1/explain/{token} · GET /v1/explain/{token}/{id} · POST /v1/explain | Free · Premium |
| Ask or check a claim | A cited answer to a question, or a verdict on a claim. POST /v1/ask | Premium |
Watch · Get told when something changes.
| Endpoint | What it answers | Tier |
|---|---|---|
| Monitors & webhooks | Get a signed webhook when a signal fires, a verdict changes or a brief is written. POST /v1/monitor · GET /v1/monitor · DELETE /v1/monitor/{id} | Premium |
Trust · Check CoinGraph's record and prove what you were told.
| Endpoint | What it answers | Tier |
|---|---|---|
| Track record | Every call CoinGraph made, what happened next, and whether it was right. GET /v1/record · GET /v1/record/{token} | Free |
| Verify a proof | The exact object CoinGraph issued, its SHA-256 fingerprint and the source calls behind it. GET /v1/verify/{id} | Free |
Agents · Whole jobs in one call.
| Endpoint | What it answers | Tier |
|---|---|---|
| Agents | List the ten ready-made agents and run one over REST. GET /v1/agents · GET /v1/agents/{id} · POST /v1/agents/{id} | Premium · Pro |
Machine-readable #
| Resource | Use |
|---|---|
| /openapi.json | OpenAPI 3.1 for code generators and agent frameworks. |
| /llms.txt | A short guide for language models. |
| /mcp | The same capabilities as MCP tools. |
Payments
Discover and Trust calls are free. Data calls have a daily free allowance; Premium and Pro calls are paid per call with x402 on Cardano preprod. Design partners use an API key. See Pricing & payments.