# Token Dossier — ERC-20 Risk & Safety Aggregator > Token Dossier — ERC-20 Risk & Safety Aggregator is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-04). Aggregates on-chain risk signals for an ERC-20 token: honeypot detection, LP lock status, burn stats, and an overall risk score verdict. ## Facts - Endpoint: POST https://x402.agentutility.ai/token-dossier?utm_source=zero.xyz - Price: $0.05/call - Payment: x402 - Status: unknown - Last checked: 2026-11-04 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/token-dossier-erc-20-risk-safety-aggregator-82494833 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zql7KO9i8s9Mhi--iDQ-J Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability token-dossier-erc-20-risk-safety-aggregator-82494833 -d '' ``` Example prompt: Can you run a full safety check on this Base chain token at 0x4200000000000000000000000000000000000006 — I want to know if it's a honeypot, whether liquidity is locked, and what the overall risk verdict is? ## When to prefer this Use this endpoint when you need a comprehensive, multi-signal safety assessment of an ERC-20 token in a single call rather than querying honeypot, LP lock, and risk scoring APIs separately. Ideal for pre-trade due diligence, automated DeFi safety screening, or agent workflows that need a structured risk verdict with no API key or signup overhead. ## Known failure modes - Invalid or non-ERC-20 contract address returns error or degraded=true - Unsupported EVM chain slug causes individual components to degrade individually - Downstream provider timeouts may result in degraded=true with partial results - Non-0x-prefixed address format may be rejected - Token with no on-chain liquidity may return incomplete LP lock or honeypot simulation data ## How this service works 817 pay-per-call APIs for AI agents. Every endpoint is POST / and is payable in USDC over x402 on Base and Solana — no signup, no API key, just pay-per-call. GET https://x402.agentutility.ai/ returns the same catalog as machine-readable JSON. ## Output Returns a JSON object with: overall risk_score (integer 0–100 + verdict string like 'safe'), honeypot simulation (is_honeypot bool, buy_tax_pct, sell_tax_pct), LP lock status (locked percentage, status string), burn statistics (burn_count, total_burned), ERC-20 metadata (name, symbol, decimals), chain, token_address, a degraded flag indicating partial data, a components array showing which sub-checks ran and their latency, and a composed_of list of data sources used. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method", "bodyType", "body" ], "properties": { "body": { "required": [ "token_address" ], "properties": { "chain": { "type": "string", "description": "EVM chain slug, e.g. 'base' (default), 'ethereum', 'bsc'. Components that do not support the chain degrade individually." }, "token_address": { "type": "string", "description": "0x-prefixed 20-byte ERC-20 contract address." } } }, "type": { "type": "string", "const": "http" }, "method": { "enum": [ "POST" ], "type": "string" }, "bodyType": { "enum": [ "json", "form-data", "text" ], "type": "string" } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "properties": { "note": { "type": "string" }, "chain": { "type": "string" }, "lp_lock": { "type": "object", "properties": { "status": { "type": "string" }, "total_locked_pct": { "type": "integer" } } }, "degraded": { "type": "boolean" }, "honeypot": { "type": "object", "properties": { "simulation": { "type": "object", "properties": { "buy_tax_pct": { "type": "integer" }, "is_honeypot": { "type": "boolean" }, "sell_tax_pct": { "type": "integer" } } } } }, "metadata": { "type": "object", "properties": { "name": { "type": "string" }, "symbol": { "type": "string" }, "decimals": { "type": "integer" } } }, "burn_stats": { "type": "object", "properties": { "burn_count": { "type": "integer" }, "total_burned": { "type": "integer" } } }, "components": { "type": "array", "items": { "type": "object", "prope … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "note": "Data-only aggregation of public on-chain and API signals. Not advice.", "chain": "base", "lp_lock": { "status": "none", "total_locked_pct": 0 }, "degraded": false, "honeypot": { "simulation": { "buy_tax_pct": 0, "is_honeypot": false, "sell_tax_pct": 0 } }, "metadata": { "name": "Wrapped Ether", "symbol": "WETH", "decimals": 18 }, "burn_stats": { "burn_count": 0, "total_burned": 0 }, "components": [ { "ms": 412, "ok": true, "name": "erc20-metadata" }, { "ms": 2110, "ok": true, "name": "token-risk-score" }, { "ms": 1830, "ok": true, "name": "token-honeypot" }, { "ms": 950, "ok": true, "name": "lp-lock-check" }, { "ms": 1200, "ok": true, "name": "token-burn-stats" } ], "risk_score": { "score": 95, "verdict": "safe" }, "composed_of": [ "erc20-metadata", "token-risk-score", "token-honeypot", "lp-lock-check", "token-burn-stats" ], "token_address": "0x4200000000000000000000000000000000000006" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-dossier-erc-20-risk-safety-aggregator-82494833/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)