{"uid":"cap_UDGaq7VHkaZzMolImwYnO","slug":"token-verdict-pre-trade-risk-check-40489387","name":"Token Verdict Pre-Trade Risk Check","description":"One combined go/no-go before an agent spends: PROCEED / CAUTION / ABORT from the token's market verdict, the counterparty wallet's sanctions, age and poisoning check, and — with a spender — its ERC-20 approvals. A leg that cannot be evaluated returns unknown and caps the verdict at CAUTION. Mode 'compact' returns the decision, the worst leg, and one summary per leg. Use this when an agent is about to swap, pay, or route funds and needs token + wallet risk in one call.","url":"https://token-verdict-production.up.railway.app/v1/pre-trade?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["full","compact"],"type":"string","description":"Optional response mode, default 'full'. 'full' returns every leg in full (signals, market data, sanctions and poisoning detail). 'compact' returns the decision, the worst leg, and one summary per leg (verdict, score, headline reason) — the same computation, a smaller response."},"chain":{"enum":["base","ethereum","solana"],"type":"string","default":"base","description":"Chain of the token leg. Wallet/allowance legs are Base-only: supplying wallet_address requires chain base."},"spender":{"type":["string","null"],"description":"Optional spender contract (Base 0x...); with wallet_address, adds the allowance leg for that spender"},"token_address":{"type":"string","description":"Token contract address (0x...) the trade would buy or receive"},"wallet_address":{"type":["string","null"],"description":"Optional counterparty / own wallet (Base 0x...) to check for sanctions, age, activity and poisoning signals"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LR0XbK2g5Nyr4n1bWrMW6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a combined PROCEED / CAUTION / ABORT go/no-go decision before an agent spends funds, by evaluating token market risk, wallet sanctions, wallet age/poisoning, and ERC-20 approval exposure in a single call.","exampleAgentPrompt":"Before we swap into 0x1234...abcd on Base, run a full pre-trade verdict — also check counterparty wallet 0xaaaa...bbbb for sanctions and poisoning, and include the allowance leg for spender 0xcccc...dddd.","exampleUseCases":[{"title":"DeFi swap safety check","prompt":"I'm about to swap USDC for this token at 0x6b175474e89094c44da98b954eedeac495271d0f on Base — run a pre-trade check and tell me if I should PROCEED or ABORT."},{"title":"Counterparty wallet screening","prompt":"Before I send payment to wallet 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae on Base, check whether it's sanctioned, freshly created, or involved in address poisoning — give me the compact verdict."},{"title":"Spender approval risk review","prompt":"I want to approve the contract 0x7a250d5630b4cf539739df2c5dacb4c659f2488d to spend my tokens on Base — first check the token at 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 and that spender's allowance risk, and tell me if I should proceed."}],"resultDescription":"A top-level verdict of PROCEED, CAUTION, or ABORT, along with the worst-scoring leg that drove the decision. In full mode, complete signal breakdowns for the token market leg, wallet sanctions/age/poisoning leg, and optionally the ERC-20 allowance leg are included. In compact mode, the decision, worst leg identifier, and a one-line summary with verdict, score, and headline reason per leg are returned. Legs that cannot be evaluated return 'unknown' and cap the overall verdict at CAUTION.","failureModes":["Token contract address not found on the specified chain — leg returns unknown, verdict capped at CAUTION","Wallet address supplied with a non-Base chain — rejected, wallet/allowance legs unavailable","Spender address provided without a wallet address — allowance leg cannot be evaluated","Token contract is not an ERC-20 — market leg may return unknown","Rate limit or upstream data provider failure — affected leg returns unknown","Malformed 0x address input — validation error returned","x402 payment not included or insufficient — 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when an AI agent is about to execute any on-chain financial action — swap, payment, fund routing — and needs a single, decisive go/no-go that bundles token market risk, wallet compliance screening, and spender approval exposure. Prefer this over calling individual token-verdict or wallet-screening endpoints separately when you need a combined risk decision with one API call and one flat fee. Especially valuable when counterparty wallet identity or an ERC-20 spender approval is part of the transaction flow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:04:26.852Z","isFirstParty":false,"canonicalSlug":"token-verdict-pre-trade-risk-check-40489387"}