{"uid":"cap_o7MdH9ctUmXuSUWskBvfQ","slug":"agent-buyer-identity-preflight-x402-purchase-governance-c9df1f7c","name":"Agent Buyer Identity Preflight | x402 Purchase Governance","description":"Machine-payable service intelligence for discovering, verifying, and monitoring identity, risk, authorization, execution-preflight, and evidence APIs before autonomous agents spend.","url":"https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/transaction/preflight-lite","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["merchant_address"],"properties":{"tx":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"Optional Base transaction hash for receipt and payment proof checks."},"owner":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"since":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T.+Z$","description":"Wallet activity lower bound. Defaults to 30 days ago."},"token":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"spender":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"gas_limit":{"type":"string","pattern":"^[0-9]+$"},"from_block":{"type":"string","pattern":"^[0-9]+$"},"wallet_address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Buyer, merchant, or workflow wallet to inspect."},"expected_amount":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Expected USDC amount for payment proof."},"contract_address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"merchant_address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Merchant or payment recipient to trust-score."},"expected_recipient":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Expected USDC recipient for payment proof."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"network":{"type":"string"},"product":{"type":"string"},"activity":{"type":"object"},"identity":{"type":"object"},"assessment":{"type":"object"},"provenance":{"type":"object"}}}}}}},"responseSchema":{"type":"json","example":{"network":"eip155:8453","product":"x402-transaction-preflight-lite","assessment":{"flags":[],"risk_level":"low","risk_score":0}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qWHXr62ADbPEyXX6e_IKE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a pre-purchase risk and identity check on a merchant wallet before an AI agent executes an x402 micropayment, returning a risk score and flags.","exampleAgentPrompt":"Before my agent pays the merchant at 0xABC123...def (Base network) $2.50 USDC for that dataset API, run a preflight trust check on that merchant address and tell me if the risk level is acceptable.","exampleUseCases":[{"title":"Safe merchant check before API purchase","prompt":"My AI agent is about to pay 0x4f8a...c291 on Base for access to a weather data API — can you run a preflight check on that merchant wallet and tell me the risk score before we proceed?"},{"title":"Verify payment recipient for dataset access","prompt":"Before sending 5.00 USDC to 0x9d3b...17ae as the expected recipient for that genomics dataset, check whether that wallet address passes the x402 governance preflight and flag any issues."},{"title":"Governance review using known transaction hash","prompt":"We just saw a transaction hash 0x8f2e1a...b4c9d on Base — can you run a preflight assessment on merchant 0x7c1d...e8a2 using that tx as proof and tell me the risk level and any flags?"}],"resultDescription":"Returns a JSON object containing the network (eip155:8453 for Base), product identifier, risk_score (0–1 numeric), risk_level (e.g. 'low', 'medium', 'high'), an array of flags describing specific concerns, an identity object with wallet provenance details, and an activity summary covering recent on-chain behavior within the specified time window.","failureModes":["Missing required merchant_address parameter returns 400 validation error","Invalid Ethereum address format (not 0x + 40 hex chars) causes schema rejection","Unknown or brand-new wallet with no on-chain history may return empty activity and indeterminate risk","Invalid transaction hash format (not 0x + 64 hex chars) returns validation error","Cloudflare Worker cold-start or rate limiting may return 503 or timeout","Wallet on a network other than Base (eip155:8453) may return unsupported network error"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to perform a governance preflight check before executing an x402 micropayment on the Base network — specifically when you want a structured risk score and flags on a merchant wallet before committing funds. Prefer this over generic on-chain explorers when you need a single opinionated risk/identity verdict rather than raw transaction data, and when operating in an automated agentic payment workflow where a human approval gate is not present.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:56:27.976Z","isFirstParty":false}