Token & contract risk report (on-chain evidence)
POST /v1/token-riskHand over a token contract address (and chain) and get one evidence-based on-chain risk report: whether the source is verified, holder concentration (top-1 / top-10 share of supply, distinguishing pools/contracts from wallets), and supply + market context, with a top-holders appendix. Evidence, never a 'safe' or 'scam' verdict - on-chain checks can't see off-chain rugs, so a clean report is not an endorsement. USDC (x402/MPP). Not cached.
Input
| Field | Type | Description |
|---|---|---|
address * | string | Token contract address (0x + 40 hex). |
chain | string | Chain: base (default), ethereum, polygon, arbitrum, optimism, bsc, gnosis, or celo. |
format | string | Response shape (default markdown report). |
Example output
{
"report": "# Token & Contract Risk Report: EXAMPLE (0x…)\n\n## Snapshot\n...\n\n## Risk summary\n... This is not financial advice and not exhaustive.",
"address": "0x0000000000000000000000000000000000000000",
"chain": "base",
"sources": [],
"tables": [
{
"name": "holders",
"label": "Top holders",
"columns": [
"Rank",
"Address",
"Share of supply",
"Type",
"Label"
],
"rows": [
[
"1",
"0x…",
"42.10%",
"contract",
"Uniswap V3 Pool"
]
]
}
],
"meta": {
"tier": "token-risk",
"address": "0x…",
"chain": "base",
"name": "Example",
"symbol": "EXMP",
"verified_source": true,
"holder_count": 1234,
"top1_share_pct": 42.1,
"top10_share_pct": 71.5,
"synthesis_model": "anthropic/claude-opus-5",
"disclaimer": "Evidence-based on-chain risk signals only. Not financial advice."
}
}
Try it - see the 402 challenge (free)
curl -i -X POST https://agent402.tools/v1/token-risk \
-H "Content-Type: application/json" \
-d '{"address":"0x4200000000000000000000000000000000000006","chain":"base"}'
The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:
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();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/v1/token-risk", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"address": "0x4200000000000000000000000000000000000006",
"chain": "base"
}),
});
Related tools
Chat completions - nano tier
POST /v1/nano/chat/completionsOpenAI-compatible chat completions, nano tier: gpt-4.1-nano, gpt-5-nano, gemini flash-lite, small llama/ministral/qwen, …
try in playground →Chat completions - auto tier (eval-ranked routing)
POST /v1/auto/chat/completionsOpenAI-compatible chat completions with server-side model choice: omit "model" (or send "auto") and the gateway routes t…
try in playground →Grounded chat (web search, OpenAI-compatible)
POST /v1/grounded/chat/completionsOpenAI-compatible chat completions GROUNDED in a live web search on every call: the gateway runs an Exa search (up to 5 …
try in playground →