{"uid":"cap_PedLf8nW6AP9vWLq1HTnV","slug":"token-security-verdict-api-x402-fff652ba","name":"Token Security & Verdict API (x402)","description":"Paid SEO tools and the **Token Security & Verdict API** (`POST /verdict`, 0.02 USDC), exposed both as REST\nendpoints and as an **MCP server** (`POST /mcp`, Streamable HTTP).\n\n### Token Security & Verdict API\n`POST /verdict` with `{\"address\": \"0x...\", \"chain\": \"base\" | \"ethereum\"}` returns a risk score (0-100), flags,\nliquidity, holder concentration, honeypot indicators, top holders and a short summary. Data: GoPlus Security,\nDexScreener and public JSON-RPC; if every source is down the result is an estimate marked `\"source\": \"estimated\"`.\nPayments go to `0x4C5D82B27E857E4FCE5607b34041aD2d9c74eD1B`; its EIP-712 domain name is **\"Token Verdict x402\"** (all other domain fields are as below).\nEvery unpaid GET/HEAD/POST returns 402 with\n`X-Payment: {\"amount\":\"0.02\",\"currency\":\"USDC\",\"recipient\":\"0x4C5D82B27E857E4FCE5607b34041aD2d9c74eD1B\",\"network\":\"base\",\"mimeType\":\"application/json\",\"resource\":\"token_verdict\"}`.\nInvalid input after a valid payment returns **400** and the payment proof is not consumed.\n\n### Standard x402 payments (recommended - settled on-chain, indexed by x402scan)\nEvery 402 carries a base64 `PAYMENT-REQUIRED` header (x402 v2): scheme `exact`, network `eip155:8453`,\nasset USDC `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`. Retry with a `PAYMENT-SIGNATURE` header (v2 PaymentPayload, EIP-3009\n`transferWithAuthorization`; v1 payloads in `X-PAYMENT` are also accepted). The server verifies via the PayAI facilitator,\nruns the tool, then settles on-chain (facilitator pays gas) and returns the receipt in `PAYMENT-RESPONSE`.\nTool errors (e.g. 400 bad input) are **not** settled. Works out of the box with `@x402/fetch` + `@x402/evm`.\n\n### Legacy payment flow (custom tx_hash proof)\n1. Call a tool without payment -> **HTTP 402**. The `X-Payment` response header contains JSON:\n   `{\"amount\",\"currency\":\"USDC\",\"recipient\",\"network\":\"base\",\"mimeType\",\"resource\"}`.\n2. Pay `amount` USDC on Base to `recipient`, then sign the EIP-712 typed data below with the payer wallet.\n3. Retry with header `X-PAYMENT: {\"tx_hash\":\"0x..\",\"payer\":\"0x..\",\"amount\":\"0.01\",\"signature\":\"0x..\"}`\n   (raw JSON or base64 JSON) -> **HTTP 200** with results and an `X-Payment-Response` receipt header.\n\nEIP-712 domain: `{name: \"SEO MCP x402\", version: \"1\", chainId: 8453, verifyingContract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913}`;\ntype `Payment(address payer, address recipient, uint256 amount, bytes32 txHash)` with `amount` in USDC atomic units (6 decimals).\nEach `tx_hash` can be redeemed once. Rate limit: 10 calls / 60s per payer (HTTP 429).\nIf a tool fails (4xx/5xx tool_error) the payment is **not** consumed and can be retried.","url":"https://seo-mcp-x402.abacusai.app/verdict?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","ethereum"],"type":"string","default":"base","description":"Chain the token lives on"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 token contract address"}}},"responseSchema":{"type":"json","example":{"tool":"token_verdict","result":{"chain":"base","flags":[],"token":{"name":"Brett","symbol":"BRETT","decimals":18,"is_proxy":false,"total_supply":9999997544.34,"owner_address":null,"is_open_source":true,"creator_address":null},"source":"live","address":"0x532f27101965dd16442e59d40670faf5ebb142e4","holders":{"holder_count":909678,"owner_percent":null,"top10_percent":25.1,"creator_percent":0,"largest_unlocked_holder_percent":11.67,"top10_percent_excluding_burn_and_locked":25.1},"sources":{"rpc":true,"goplus":true,"dexscreener":true},"summary":"Brett (BRETT) on Base scores 0/100 risk (low): verdict LIKELY_SAFE. No honeypot, tax or ownership red flags were detected. Not financial advice.","verdict":"LIKELY_SAFE","chain_id":8453,"honeypot":{"blacklist":false,"cannot_buy":false,"is_honeypot":false,"tax_modifiable":false,"buy_tax_percent":0,"cannot_sell_all":false,"sell_tax_percent":0,"transfer_pausable":false,"transfer_tax_percent":0,"creator_honeypot_history":false},"liquidity":{"main_pair":{"dex":"aerodrome","price_usd":0.004439,"liquidity_usd":666465.67},"pair_count":30,"lp_locked_percent":null,"total_liquidity_usd":1500000},"risk_level":"low","risk_score":0,"top_holders":[{"tag":null,"address":"0x7061f0b28f5a95aae717905bb59aa4e08c165268","balance":1167415538.59,"percent":11.67,"is_locked":false,"is_contract":false}],"generated_at":"2026-11-01T12:00:00+00:00"},"payment":{"payer":"0x0000000000000000000000000000000000000001","amount":"0.02","tx_hash":"0x0000000000000000000000000000000000000000000000000000000000000000","currency":"USDC","response_time_ms":850}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JTNEaEN9Edj49tFJs8_gz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a comprehensive security verdict for an ERC-20 token on Base or Ethereum, including risk score, honeypot detection, liquidity, holder concentration, and a plain-language summary.","exampleAgentPrompt":"Can you check whether the token at address 0x532f27101965dd16442e59d40670faf5ebb142e4 on Base is safe — give me its risk score, honeypot status, liquidity, and a verdict?","exampleUseCases":[{"title":"Pre-trade token safety check","prompt":"Before I buy this token on Base — 0x532f27101965dd16442e59d40670faf5ebb142e4 — can you run a security check and tell me if it's a honeypot, what its risk score is, and whether the liquidity looks healthy?"},{"title":"Rug pull detection for new token","prompt":"I just found a new Ethereum token at 0xabcdef1234567890abcdef1234567890abcdef12 — can you analyze it for rug pull risks, suspicious holder concentration, and any sell tax or blacklist flags?"},{"title":"Token due diligence for DeFi bot","prompt":"Run a full security verdict on the Ethereum token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 — I need the risk level, top 10 holders breakdown, liquidity details, and the overall verdict before my bot places a trade."}],"resultDescription":"A JSON object containing: verdict label (e.g. LIKELY_SAFE), risk score 0-100, risk level, security flags array, honeypot analysis (buy/sell tax, cannot_sell_all, blacklist, transfer_pausable), token metadata (name, symbol, decimals, is_open_source, owner_address), liquidity info (total USD, main DEX pair, price, LP lock status), holder stats (top10 percent, largest holder percent, holder count), top holders list with addresses and balances, data sources used (RPC, GoPlus, DexScreener), and a plain-English summary sentence. Also includes payment metadata (payer, tx_hash, USDC amount, response time).","failureModes":["Invalid contract address format (must match ^0x[0-9a-fA-F]{40}$) — returns validation error","Token not found on specified chain — may return empty flags with limited data","Unsupported chain value (only 'base' and 'ethereum' accepted) — returns enum validation error","Payment failure via x402 protocol — returns 402 Payment Required","External data source (GoPlus, DexScreener, RPC) unavailable — partial results or timeout","Very new or low-liquidity token may have incomplete holder or liquidity data"],"whenToPreferThis":"Choose this endpoint when you need a fast, multi-signal ERC-20 security assessment combining on-chain RPC data, GoPlus security flags, and DexScreener liquidity — all in one call. It is specifically suited for Base and Ethereum tokens and returns a structured verdict with a human-readable summary, making it ideal for pre-trade checks, DeFi bot guardrails, or token screening workflows. Prefer it over building your own aggregation when you need honeypot detection, tax analysis, holder concentration, and liquidity in a single $0.02 pay-per-call API.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-22T00:32:11.653Z","isFirstParty":false,"canonicalSlug":"token-security-verdict-api-x402-fff652ba"}