Token diligence (coin list)
POST /api/token-diligenceOne 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).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
coins | array of string | yes | 1 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
POST /api/token-diligencefrom $0.01 USDCPAYMENT-SIGNATUREon 14 chains200 OKAgent402-ReceiptEd25519Example 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)."
]
}| Field | Type | Always present | In the example |
|---|---|---|---|
product | string | yes | token-diligence |
generatedAt | string | yes | 2026-11-18T23:40:00.000Z |
coins | number | yes | 2 |
comparison | object | yes | 4 fields: byMarketCap, byReturn1y, byVolatilityLowFirst, flagged |
rows | array of objects | yes | 1 item in the example |
method | string | yes | turnover24h is 24h volume over market cap; fdvToMarketCap is fully diluted va... |
pricing | object | yes | 4 fields: units, unitPartsUsd, priceUsd, rule |
source | string | yes | computed from CoinGecko coin profiles and OHLC candles |
credits | array of string | yes | 1 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
coinsis required. An input the tool rejects returns an HTTP 4xx whose body carrieserror,tool,expected,requiredandexample, so the caller can correct it.- A paid call that ends in any status of 400 or above is not charged over x402, MPP or a prepaid credits key: settlement runs after the tool and only on a successful response. The exception is a Tempo push credential, a transfer the buyer sent before the call: it settles before the tool runs, so if the tool then fails the payment is recorded as a refund owed to the paying wallet.
- Wallet-only: this tool reaches the network or stored state, so it has no proof-of-work tier. A prepaid card-credits key issued earlier (
Authorization: Bearer a402_...) also pays it. - Priced per request: the 402 quotes this body, between $0.01 and $0.198.
- A
GETorHEADto /api/token-diligence returns the same 402 quote, so the price can be read without a body. - An
Idempotency-Keyheader makes a retried paid call replay the first 200 instead of charging again (an answer larger than 1 MB is not replayed).
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
Label a known EVM address from a curated, committed dataset: major stablecoin + token contracts (the USDC and USDG.
Coin OHLC candles
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
Live price, market cap, 24h volume and 24h change for ERC-20 / SPL / other chain tokens looked up by CONTRACT ADDRESS.
DeFi token 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)
Who owns this NFT?
ERC-20 token metadata
Resolve an ERC-20 contract address to its on-chain metadata: symbol, decimals, name, and logo URL where available.