Skip to content

Token diligence (coin list)

quoted per request from $0.01USDC via x402POST /api/token-diligence

One market diligence read for up to 20 coins in one call: per coin the profile and market snapshot (price, market cap, fully diluted value, volume, supply, all-time high) with turnover, dilution and circulating share computed, one year of candles reduced to return, largest drawdown and annualized volatility, and contract addresses per chain; flags for high dilution, thin turnover, far below the all-time high, high volatility and a deep drawdown, with the list ranked by market cap, one-year return and volatility. Send POST /api/token-diligence with the required field coins and pay quoted per request from $0.01 over x402 or MPP (there is no free tier). It returns a JSON object with product, generatedAt, coins, comparison, rows and 4 more.

Priced per coin: the two tools it runs (coin-profile, coin-ohlc) less 10%, $0.01 a coin, quoted in the 402 for the coins you send. Coins by coin id (coin-search finds one). Deterministic code, no model; market facts, not investment advice. Data provided by CoinGecko (https://www.coingecko.com/en/api).

Category: Crypto & onchain dataTags: crypto token diligence volatility drawdown dilution portfolio bundle

Try in playground →

Parameters

NameTypeRequiredDescription
coinsarray of stringyes1 to 20 coin ids as coin-search returns them (a comma-separated string also works)

Example request

curl -i -X POST https://agent402.tools/api/token-diligence \
  -H "Content-Type: application/json" \
  -d '{"coins":["bitcoin","chainlink"]}'

Without payment this returns HTTP 402 Payment Required with the exact price for token-diligence; any x402 v2 or MPP client pays it and retries.

Watch a call get paid

RequestPOST /api/token-diligence
402from $0.01 USDC
SignPAYMENT-SIGNATURE
Settleon 14 chains
Answer200 OK
ReceiptAgent402-ReceiptEd25519

Example response

{
  "product": "token-diligence",
  "generatedAt": "2026-11-18T23:40:00.000Z",
  "coins": 2,
  "comparison": {
    "byMarketCap": [
      {
        "rank": 1,
        "id": "bitcoin",
        "value": 1810000000000
      }
    ],
    "byReturn1y": [
      {
        "rank": 1,
        "id": "bitcoin",
        "value": -1.2
      }
    ],
    "byVolatilityLowFirst": [
      {
        "rank": 1,
        "id": "bitcoin",
        "value": 41.7
      }
    ],
    "flagged": [
      {
        "id": "chainlink",
        "flags": [
          "farBelowATH",
          "deepDrawdown1y"
        ]
      }
    ]
  },
  "rows": [
    {
      "id": "chainlink",
      "symbol": "LINK",
      "name": "Chainlink",
      "rank": 17,
      "flags": [
        "farBelowATH"
      ],
      "market": {
        "price": 9.05,
        "marketCap": 6942568367,
        "fullyDilutedValuation": 9053359373,
        "volume24h": 183294158,
        "change7dPct": -11.1,
        "change30dPct": -24.87,
        "change1yPct": -34.28,
        "ath": 52.7,
        "athChangePct": -82.82,
        "currency": "usd"
      },
      "supply": {
        "circulating": 766849970.42,
        "total": 1000000000,
        "max": 1000000000,
        "circulatingShare": 0.7668
      },
      "computed": {
        "turnover24h": 0.0264,
        "fdvToMarketCap": 1.304,
        "return1yPct": -34.1,
        "maxDrawdown1yPct": 55.5,
        "volatilityAnnualizedPct": 71.3,
        "candles": {
          "days": 365,
          "bars": 92,
          "granularity": "4d"
        }
      },
      "profile": {
        "genesisDate": "2017-09-16",
        "categories": [
          "Infrastructure",
          "Oracle"
        ],
        "homepage": "https://chain.link/",
        "chains": 89,
        "contracts": [
          {
            "platform": "ethereum",
            "contract": "0x514910771af9ca656af840dff83e8264ecf986ca"
          }
        ],
        "contractsPartial": {
          "returned": 5,
          "matched": 89,
          "complete": false,
          "truncated": true
        }
      }
    }
  ],
  "method": "turnover24h is 24h volume over market cap; fdvToMarketCap is fully diluted value over market cap.",
  "pricing": {
    "units": 2,
    "unitPartsUsd": 0.011,
    "priceUsd": 0.02,
    "rule": "the sum of each unit's tools (coin-profile, coin-ohlc) times the units, less 10%, rounded up to $0.001"
  },
  "source": "computed from CoinGecko coin profiles and OHLC candles",
  "credits": [
    "Data provided by CoinGecko (https://www.coingecko.com/en/api)."
  ]
}
FieldTypeAlways presentIn the example
productstringyestoken-diligence
generatedAtstringyes2026-11-18T23:40:00.000Z
coinsnumberyes2
comparisonobjectyes4 fields: byMarketCap, byReturn1y, byVolatilityLowFirst, flagged
rowsarray of objectsyes1 item in the example
methodstringyesturnover24h is 24h volume over market cap; fdvToMarketCap is fully diluted va...
pricingobjectyes4 fields: units, unitPartsUsd, priceUsd, rule
sourcestringyescomputed from CoinGecko coin profiles and OHLC candles
creditsarray of stringyes1 item in the example

From an MCP client

catalog.call {
  "slug": "token-diligence",
  "params": {
    "coins": [
      "bitcoin",
      "chainlink"
    ]
  }
}

The hosted connector at https://agent402.tools/mcp needs a payment for token-diligence; the stdio package pays it from a wallet or from an AGENT402_CREDITS_KEY issued earlier. Local install: npx -y agent402-mcp@0.14.0.

Errors and behavior

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
client.setSpendControls?.({ maxAmountPerPayment: "$0.198" }); // refuse any quote above this tool's price
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/token-diligence", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "coins": [
      "bitcoin",
      "chainlink"
    ]
  }),
});

Related tools

Known-address label lookup

FREE w/ computeor $0.001POST /api/address-label

Label a known EVM address from a curated, committed dataset: major stablecoin + token contracts (the USDC and USDG.

Coin OHLC candles

$0.003GET /api/coin-ohlc

OHLC candles for a coin: days 1 (30-min candles), 7 or 14 (4-hour), 30 / 90 / 180 / 365 (daily), in any vs currency.

Token price by contract address

$0.005GET /api/coin-price-by-contract

Live price, market cap, 24h volume and 24h change for ERC-20 / SPL / other chain tokens looked up by CONTRACT ADDRESS.

DeFi token screener

$0.005GET /api/defi-screener

Screen the DeFi category's 250 largest tokens with computed columns: share of the category's market cap, turnover (24h.

NFT owner lookup (ERC-721 ownerOf)

$0.002GET /api/erc721-owner

Who owns this NFT?

ERC-20 token metadata

$0.001POST /api/token-metadata

Resolve an ERC-20 contract address to its on-chain metadata: symbol, decimals, name, and logo URL where available.