Free · PremiumMCP tool: check_token

The core check. Seven dimensions are rated ok, caution or avoid from live data, and the worst of them drives the verdict. GET is the standard check and is free. POST scores it against your order size and your own rules.

Standard check #

GET/v1/evaluate/{token}

Parameters

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

Chainlink, standard check

Request

curl "https://coingraph.ai/api/v1/evaluate/chainlink"

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

{
  "object": "evaluation",
  "id": "eval_b0a5ee5a25b634682506",
  "as_of": "2026-10-06T23:20:00.000Z",
  "data": {
    "token": {
      "id": "chainlink",
      "symbol": "LINK",
      "name": "Chainlink",
      "rank": 14
    },
    "verdict": "proceed",
    "confidence": 0.95,
    "dimensions": {
      "momentum": {
        "rating": "ok",
        "reasons": [
          {
            "text": "1h +0.36%, 24h +0.73%: nothing stretched",
            "source": "coingecko:/coins/markets"
          }
        ]
      },
      "liquidity": {
        "rating": "ok",
        "reasons": [
          {
            "text": "$3.3M available within 2% of the price on tracked order books",
            "source": "ccxt:fetchOrderBook",
            "info": true
          }
        ]
      },
      "leverage": {
        "rating": "ok",
        "reasons": [
          {
            "text": "Funding 0.01% per 8h: leverage not crowded",
            "source": "ccxt:fetchFundingRates"
          }
        ]
      },
      "onchain": {
        "rating": "ok",
        "reasons": [
          {
            "text": "Exchange net flow $-411.9K in 24h: normal",
            "source": "nownodes:eth_getLogs",
            "info": true
          }
        ]
      },
      "supply": {
        "rating": "ok",
        "reasons": [
          {
            "text": "FDV / market cap 1.34",
            "source": "coingecko:/coins/markets",
            "info": true
          },
          {
            "text": "Top 10 holders own 39% of supply",
            "source": "goplus/nownodes holders",
            "info": true
          },
          "… 1 more"
        ]
      },
      "context": {
        "rating": "ok",
        "reasons": [
          {
            "text": "No fundamental or mood flags",
            "source": "coingraph"
          }
        ]
      },
      "contract": {
        "rating": "ok",
        "reasons": [
          {
            "text": "No contract risks found on the ETH contract (home chain)",
            "source": "goplus:/token_security"
          }
        ]
      }
    },
    "reasons": [
      {
        "dimension": "momentum",
        "text": "1h +0.36%, 24h +0.73%: nothing stretched",
        "source": "coingecko:/coins/markets"
      },
      {
        "dimension": "liquidity",
        "text": "$3.3M available within 2% of the price on tracked order books",
        "source": "ccxt:fetchOrderBook",
        "info": true
      },
      "… 1 more"
    ],
    "size_check": null,
    "policy_check": null,
    "watch_next": [],
    "snapshot": {
      "market": {
        "price_usd": 13.96,
        "market_cap_usd": 10444287501,
        "fully_diluted_valuation_usd": 13961085301,
        "volume_24h_usd": 263776470,
        "rank": 14,
        "change_pct": {
          "15m": 0.14,
          "1h": 0.36,
          "4h": 0.22,
          "24h": 0.73,
          "7d": -5.2107,
          "30d": 8.1012,
          "200d": 40.1246,
          "1y": -40.4316
        },
        "high_24h_usd": 14.11,
        "low_24h_usd": 13.72,
        "ath_usd": 52.7,
        "ath_date": "2021-05-09T16:13:57.000Z",
        "from_ath_pct": -73.5,
        "atl_usd": 0.148183,
        "from_atl_pct": 9323.01,
        "volatility_24h_pct": 2.44,
        "…": "3 more fields"
      },
      "liquidity_depth": {
        "bid": 3449590,
        "ask": 3265820,
        "bid_ask_ratio": 1.06
      },
      "derivatives": {
        "funding": [
          {
            "venue": "binanceusdm",
            "symbol": "LINK/USDT:USDT",
            "rate_pct": 0.01,
            "next_rate_pct": null,
            "next_at": null,
            "annualised_pct": 11,
            "mark": 13.959,
            "index": 13.96491236,
            "basis_pct": -0.04
          },
          {
            "venue": "bybit",
            "symbol": "LINK/USDT:USDT",
            "rate_pct": 0.0089,
            "next_rate_pct": null,
            "next_at": null,
            "annualised_pct": 9.8,
            "mark": 13.958,
            "index": 13.966,
            "basis_pct": -0.06
          },
          "… 1 more"
        ],
        "open_interest_change": {
          "1h": 0.67,
          "4h": 0.42,
          "24h": 0.59
        },
        "liquidations_1h": {
          "count": 0,
          "usd": 0,
          "longs_usd": 0,
          "shorts_usd": 0
        }
      },
      "onchain_flows_24h": {
        "inflow_usd": 2109570,
        "outflow_usd": 2521420,
        "net_usd": -411856
      },
      "supply": {
        "fdv_to_market_cap": 1.34,
        "top_holders": {
          "top10": 39,
          "top20": 49.4,
          "as_of": "2026-10-06T14:52:00.000Z"
        }
      }
    },
    "disclaimer": "CoinGraph never executes, custodies or advises. The caller decides.",
    "hash": "191799c06ad780515560070f892e1c19d7dd72e22b844e127980674a496e5599",
    "verify_url": "https://coingraph.ai/api/v1/verify/eval_b0a5ee5a25b634682506"
  },
  "sources": [
    {
      "provider": "coingecko",
      "endpoint": "/coins/markets",
      "as_of": "2026-10-06T23:20:00.000Z"
    },
    {
      "provider": "ccxt",
      "endpoint": "fetchOrderBook",
      "as_of": "2026-10-06T23:20:00.000Z"
    },
    "… 17 more"
  ]
}

Check sized to your order and rules #

POST/v1/evaluate

Parameters

tokenstring· bodyrequired
Token id (cardano, chainlink, solana), symbol (ADA, LINK, SOL) or contract address.
size_usdnumber· bodyoptional
Your intended order size in USD. Adds a size check against order-book depth, daily volume and the best on-chain route.
policyobject· bodyoptional
Your rules, each reported pass, fail or unknown: min_depth_usd, max_top10_holder_pct, max_funding_pct, max_exchange_inflow_usd, allow_mint_authority, max_unlock_pct.

Solana, $5K order with three rules

Request

curl -X POST "https://coingraph.ai/api/v1/evaluate" \
  -H "content-type: application/json" \
  -d '{"token":"solana","size_usd":5000,"policy":{"min_depth_usd":1000000,"max_funding_pct":0.05,"max_top10_holder_pct":60}}'

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

{
  "object": "evaluation",
  "id": "eval_ef166b4cff507851d089",
  "as_of": "2026-10-06T23:20:00.000Z",
  "data": {
    "token": {
      "id": "solana",
      "symbol": "SOL",
      "name": "Solana",
      "rank": 7
    },
    "verdict": "proceed",
    "confidence": 0.86,
    "dimensions": {
      "momentum": {
        "rating": "ok",
        "reasons": [
          {
            "text": "1h -0.59%, 24h -0.11%: nothing stretched",
            "source": "coingecko:/coins/markets"
          }
        ]
      },
      "liquidity": {
        "rating": "ok",
        "reasons": [
          {
            "text": "$109.7M available within 2% of the price across exchanges (CoinGecko)",
            "source": "coingecko:/coins/{id}/tickers",
            "info": true
          },
          {
            "text": "A $5K order is 0% of daily volume with ~0% impact",
            "source": "ccxt:fetchOrderBook",
            "info": true
          }
        ]
      },
      "leverage": {
        "rating": "ok",
        "reasons": [
          {
            "text": "Funding 0.01% per 8h: leverage not crowded",
            "source": "ccxt:fetchFundingRates"
          }
        ]
      },
      "onchain": {
        "rating": "ok",
        "reasons": [
          {
            "text": "Exchange reserves +0% in 24h (stable)",
            "source": "nownodes:blockbook:/address"
          }
        ]
      },
      "supply": {
        "rating": "ok",
        "reasons": [
          {
            "text": "FDV / market cap 1.08",
            "source": "coingecko:/coins/markets",
            "info": true
          },
          {
            "text": "Unlock schedule: unassessed (no free source)",
            "source": "coingraph",
            "info": true
          }
        ]
      },
      "context": {
        "rating": "ok",
        "reasons": [
          {
            "text": "4 headline(s) in 24h",
            "source": "rss"
          }
        ]
      },
      "contract": {
        "rating": "unassessed",
        "reasons": [
          {
            "text": "Native coin: no token contract to check",
            "source": "coingraph"
          }
        ]
      }
    },
    "reasons": [
      {
        "dimension": "momentum",
        "text": "1h -0.59%, 24h -0.11%: nothing stretched",
        "source": "coingecko:/coins/markets"
      },
      {
        "dimension": "liquidity",
        "text": "$109.7M available within 2% of the price across exchanges (CoinGecko)",
        "source": "coingecko:/coins/{id}/tickers",
        "info": true
      },
      {
        "dimension": "leverage",
        "text": "Funding 0.01% per 8h: leverage not crowded",
        "source": "ccxt:fetchFundingRates"
      }
    ],
    "size_check": {
      "order_usd": 5000,
      "depth_2pct_usd": {
        "bid": 112777000,
        "ask": 109658000
      },
      "estimated_impact_pct": 0,
      "share_of_24h_volume_pct": 0
    },
    "policy_check": {
      "min_depth_usd": {
        "result": "pass",
        "detail": "required $1M, available $109.7M"
      },
      "max_top10_holder_pct": {
        "result": "unknown",
        "detail": "limit 60%, actual unassessed%"
      },
      "max_funding_pct": {
        "result": "pass",
        "detail": "limit 0.05%, actual 0.01%"
      }
    },
    "watch_next": [],
    "snapshot": {
      "market": {
        "price_usd": 120.54,
        "market_cap_usd": 70932190287,
        "fully_diluted_valuation_usd": 76579257040,
        "volume_24h_usd": 2461694229,
        "rank": 7,
        "change_pct": {
          "15m": -0.27,
          "1h": -0.59,
          "4h": 0.1,
          "24h": -0.11,
          "7d": 1.6691,
          "30d": 14.0916,
          "200d": 34.3984,
          "1y": -48.3919
        },
        "high_24h_usd": 121.91,
        "low_24h_usd": 119,
        "ath_usd": 293.31,
        "ath_date": "2025-01-19T03:15:27.000Z",
        "from_ath_pct": -58.9,
        "atl_usd": 0.500801,
        "from_atl_pct": 23969.5,
        "volatility_24h_pct": 2.25,
        "…": "3 more fields"
      },
      "liquidity_depth": "unassessed",
      "derivatives": {
        "funding": [
          {
            "venue": "binanceusdm",
            "symbol": "SOL/USDT:USDT",
            "rate_pct": 0.01,
            "next_rate_pct": null,
            "next_at": null,
            "annualised_pct": 11,
            "mark": 120.49,
            "index": 120.54760211,
            "basis_pct": -0.05
          },
          {
            "venue": "bybit",
            "symbol": "SOL/USDT:USDT",
            "rate_pct": 0.01,
            "next_rate_pct": null,
            "next_at": null,
            "annualised_pct": 11,
            "mark": 120.473,
            "index": 120.547,
            "basis_pct": -0.06
          },
          {
            "venue": "okx",
            "symbol": "SOL/USDT:USDT",
            "rate_pct": 0.01,
            "next_rate_pct": null,
            "next_at": "2026-10-07T08:00:00.000Z",
            "annualised_pct": 11,
            "mark": null,
            "index": null,
            "basis_pct": null
          }
        ],
        "open_interest_change": {
          "1h": -0.29,
          "4h": 0.66,
          "24h": 0.13
        },
        "liquidations_1h": {
          "count": 0,
          "usd": 0,
          "longs_usd": 0,
          "shorts_usd": 0
        }
      },
      "supply": {
        "fdv_to_market_cap": 1.08,
        "top_holders": "unassessed"
      }
    },
    "disclaimer": "CoinGraph never executes, custodies or advises. The caller decides.",
    "hash": "ab9539cd52f00e0e0de3673dfdc179a1d52c2518e44ac0b958e7a28d08d98b21",
    "verify_url": "https://coingraph.ai/api/v1/verify/eval_ef166b4cff507851d089"
  },
  "sources": [
    {
      "provider": "coingecko",
      "endpoint": "/coins/markets",
      "as_of": "2026-10-06T23:20:00.000Z"
    },
    {
      "provider": "ccxt",
      "endpoint": "fetchTickers",
      "as_of": "2026-10-06T23:20:00.000Z"
    },
    {
      "provider": "coingecko",
      "endpoint": "/coins/{id}/tickers",
      "as_of": "2026-10-06T12:41:24.814Z"
    },
    "… 11 more"
  ]
}

Response #

Inside data:

Field	Contents
`verdict`	`proceed`, `caution` or `avoid`.
`confidence`	0 to 1: how much of the data was available and fresh.
`dimensions`	momentum, liquidity, leverage, onchain, supply, context, contract: each with a rating, reasons and sources.
`reasons`	The statements that drive the verdict, each with its source.
`size_check (POST)`	Your order against 2% depth and daily volume, estimated impact, best on-chain quote.
`policy_check (POST)`	pass, fail or unknown per rule.
`watch_next`	What would change the verdict.
`id, verify_url`	For the public record and the proof.

i

Note

Reasons marked info are context only and never move the verdict.

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.

Evaluate a token

Standard check #

Check sized to your order and rules #

Response #

Pricing #