{"uid":"cap_rkuWm-EUNE3L8kGTsbKa7","slug":"fhi-base-transaction-risk-dossier-a27d15b3","name":"FHI Base Transaction Risk Dossier","description":"Decision-ready Base transaction risk evidence for autonomous agents, payable in Base USDC through x402.","url":"https://polished-truth-c514.fhi-llc-1118.workers.dev/api/v1/base-transaction-risk-dossier?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tokenAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Base ERC-20 token to evaluate before a trade"},"recipientAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Base USDC recipient, router, or counterparty address"}}},"responseSchema":{"type":"json","example":{"token":{"market":{"liquidityUsd":200000,"volume24hUsd":100000},"symbol":"WETH"},"reasons":["recipient_is_contract","token_liquidity_observed"],"sources":["Base Blockscout public explorer","Dexscreener public API"],"decision":"REVIEW","recipient":{"address":"0x0000000000000000000000000000000000000000","signals":["contract_account"]},"generatedAt":"2026-10-21T00:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yrPtzESva9ttZxGqAYBRQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a decision-ready risk assessment dossier for a Base blockchain token and/or recipient address, including liquidity signals, contract flags, and a REVIEW/APPROVE/REJECT recommendation.","exampleAgentPrompt":"Before I swap into this token, can you pull a full risk dossier on Base token 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 and check the recipient router 0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD for any contract or liquidity red flags?","exampleUseCases":[{"title":"Pre-trade token safety check","prompt":"I'm about to buy some of this Base token at 0x4200000000000000000000000000000000000006 — can you run a risk dossier on it and tell me if the liquidity and volume look healthy enough to proceed?"},{"title":"Counterparty contract risk review","prompt":"I need to send USDC through this router on Base at 0x198EF79F1F515F02dFE9e3115eD9fC07183f02fC — can you check whether it's a verified contract and flag any risk signals before I approve the transaction?"},{"title":"DeFi agent pre-execution guardrail","prompt":"Before my trading bot executes this swap, run a risk assessment on Base token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 going through recipient 0x0000000000000000000000000000000000000000 and tell me if the decision is APPROVE, REVIEW, or REJECT."}],"resultDescription":"A JSON dossier containing: a top-level decision field (e.g. APPROVE, REVIEW, REJECT), an array of human-readable reason codes, the token's market data (liquidity in USD, 24h volume in USD, symbol), recipient address signals (e.g. contract_account), the data sources consulted (Base Blockscout, Dexscreener), and a generatedAt ISO timestamp.","failureModes":["Invalid address format (not a 40-char hex) returns validation error","Token address not found on Base returns no market data or empty signals","Payment failure via x402 (insufficient USDC balance) blocks the request","Network timeout from upstream data sources (Blockscout, Dexscreener) may return stale or partial data","Unknown or undeployed contract addresses may return minimal signal set with inconclusive decision"],"whenToPreferThis":"Choose this endpoint when an AI agent needs a single, structured, decision-ready risk verdict before executing a Base blockchain transaction — particularly when both token liquidity risk and recipient/counterparty contract risk need to be evaluated together. Prefer this over raw block explorer queries when you need a pre-synthesized APPROVE/REVIEW/REJECT signal without building your own aggregation logic. Best suited for autonomous DeFi agents, trading bots, or wallet UIs that need fast, actionable risk evidence payable per-call in USDC via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:30:18.591Z","isFirstParty":false,"canonicalSlug":"fhi-base-transaction-risk-dossier-a27d15b3"}