Token & contract risk report - PRO (static scan + reputation)
POST /v1/token-risk/proThe deeper tier (model-backed): everything in the standard report plus a deterministic static-pattern scan of the verified source (tx.origin auth, delegatecall, selfdestruct, unchecked calls, reentrancy surface, etc. - heuristic triage, not a formal audit) and a web reputation check. Send POST /v1/token-risk/pro with the required field address and pay $0.85 per call over x402 with USDC on an EVM chain or MPP. It returns a JSON object with report, address, chain, sources, tables and 1 more.
Still evidence, never a verdict. USDC (x402/MPP). Not cached. Takes up to 3 minutes to answer: send the paid call with "Prefer: respond-async" to get a job link at once and collect the answer from it (on x402 the payment settles only on a delivered result), or with "Prefer: wait=180" and keep the connection open for at least 210 seconds, because a client that disconnects first loses the answer. A paid call with neither header is answered 400 before any payment is taken.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
address | string | yes | Token contract address (0x + 40 hex). Also accepted as addr, wallet, account. |
chain | string | no | Chain, one of: base, ethereum, polygon, arbitrum, optimism, bsc, gnosis (default base). |
format | string (one of: markdown, json) | no | Response shape (default markdown report). |
Example request
curl -i -X POST https://agent402.tools/v1/token-risk/pro \
-H "Content-Type: application/json" \
-d '{"address":"0x4200000000000000000000000000000000000006","chain":"base"}'Without payment this returns HTTP 402 Payment Required with the exact price for token-risk-pro; any x402 v2 or MPP client pays it and retries.
Watch a call get paid
POST /v1/token-risk/pro$0.85 USDCPAYMENT-SIGNATUREon 11 chains200 OKAgent402-ReceiptEd25519Example response
{
"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-pro",
"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."
}
}| Field | Type | Always present | In the example |
|---|---|---|---|
report | string | yes | # Token & Contract Risk Report: EXAMPLE (0x…) ## Snapshot ... ## Risk summa... |
address | string | yes | 0x0000000000000000000000000000000000000000 |
chain | string | yes | base |
sources | array | yes | 0 items in the example |
tables | array of objects | yes | 1 item in the example |
meta | object | yes | 11 fields: tier, address, chain, name, symbol, verified_source and 5 more |
From an MCP client
catalog.call {
"slug": "token-risk-pro",
"params": {
"address": "0x4200000000000000000000000000000000000006",
"chain": "base"
}
}The hosted connector at https://agent402.tools/mcp needs a payment for token-risk-pro; 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
addressis 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.
- Wallet-only: this tool runs a model, so it has no proof-of-work tier. A prepaid card-credits key issued earlier (
Authorization: Bearer a402_...) also pays it. - Model-backed: the answer is generated by a model, so the same input can produce a different result.
- Long-running: payment settles after the work finishes, so x402 is offered on EVM chains only and MPP on Base, Celo or card; Tempo is not offered.
- Usually answers in about 90 seconds and takes up to 180 seconds. Send the paid call with
Prefer: respond-asyncto get202and a job link at once, then pollGET /api/jobs/{id}for its stage, progress and ETA until it has the answer; payment still settles only when the answer is ready, except a Tempo transfer sent before the call, which is repaid after on-chain proof if the run fails. To wait on the connection instead, sendPrefer: wait=180and keep it open that long. A paid call with neither header is answered400before any payment is taken. - A
GETorHEADto /v1/token-risk/pro 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 and a streamed response are 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.85" }); // 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/v1/token-risk/pro", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"address": "0x4200000000000000000000000000000000000006",
"chain": "base"
}),
});Related tools
Token & contract risk report (on-chain evidence)
Hand over a token contract address (and chain) and get one evidence-based, model-backed on-chain risk report: whether.
Solidity heuristic pattern scan
Deterministic static pattern scan of Solidity smart-contract source text - a fixed ruleset flagging tx.origin.
Domain security & deliverability audit (graded)
Hand over a domain and get one graded, model-backed security & email-deliverability audit: SPF, DMARC, DKIM and MX (why.
Domain security audit - PRO (attack surface + stack)
The deeper tier (model-backed): everything in the standard audit plus the attack surface from Certificate Transparency.
Company due-diligence dossier (grounded, cited)
Hand over a ticker and get one due-diligence dossier back.
Company due-diligence dossier - MAX (exhaustive)
The exhaustive due-diligence tier (model-backed): more filings, a full year of Form 4 insider activity, wider web.