{"uid":"cap_CGxP4C0OquD4_zT8eC6l7","slug":"agent-buyer-identity-preflight-x402-purchase-governance-e528c9cc","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-plus","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}$"},"owner":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"since":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T.+Z$"},"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}$"},"expected_amount":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$"},"contract_address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"merchant_address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"expected_recipient":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}}},"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-plus","assessment":{"flags":[],"risk_level":"low","risk_score":0}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ACsPZ4k_gHTp3vU_rKEil","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","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 assessment for an AI agent attempting to buy an x402-gated API, dataset, or tool on Base.","exampleAgentPrompt":"Before my agent wallet 0xABC...123 pays merchant 0xDEF...456 the expected 5.00 USDC for that x402 API, run the SignGate preflight check to make sure the buyer role, price, and approval policy all clear.","exampleUseCases":[{"title":"Pre-purchase risk screen for agent","prompt":"My agent is about to pay merchant 0x1234...abcd 2.50 USDC for a paid dataset — can you run the x402 preflight check on wallet 0xaaaa...bbbb to confirm the risk level is low and nothing is flagged before we proceed?"},{"title":"Governance check for sensitive tool purchase","prompt":"Before my AI agent buys that high-sensitivity x402 analytics tool from merchant 0xdeadbeef...1234, verify that wallet 0xagent...5678 meets the buyer identity and approval policy requirements — I need to see the risk score and any flags."},{"title":"Allowance and recipient validation before payment","prompt":"Check whether spender 0xspend...1111 is authorized to pay expected recipient 0xrecip...2222 up to 10.00 USDC via the x402 contract at 0xcontract...3333 — give me the full preflight assessment before the agent submits anything."}],"resultDescription":"Returns a JSON object containing the network (e.g. eip155:8453 for Base), product identifier, risk_score (numeric), risk_level (e.g. 'low'), and a flags array listing any governance or identity issues detected. May also include identity, activity, and provenance sub-objects describing the buyer agent's profile and transaction history.","failureModes":["Missing or malformed merchant_address returns a 400 validation error","Invalid Ethereum address format (not matching ^0x[a-fA-F0-9]{40}$) rejected at input","High risk_score or non-empty flags array indicates agent should not proceed with purchase","Endpoint unavailable or Cloudflare Worker error returns 5xx with no assessment","expected_amount not matching on-chain allowance may trigger a flag in the assessment","Unknown or unregistered merchant address may return risk_level 'unknown' or elevated score"],"whenToPreferThis":"Use this endpoint when an AI agent is about to execute an x402 micropayment and you need a governance gate — specifically to verify buyer identity, check price/sensitivity thresholds, and confirm approval policy before committing funds. Prefer this over a generic transaction validator when the purchase involves an x402-gated resource on Base and you need a structured risk_score plus flags rather than just a boolean pass/fail.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:46:58.587Z","isFirstParty":false}