{"uid":"cap_ZIROGgKSVQeATdrv08WCw","slug":"nomos-payment-preflight-decision-api-04197ae6","name":"Nomos Payment Preflight Decision API","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/x402/v1/decision/payment-preflight","method":"POST","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":["POST"],"type":"string"},"queryParams":{"type":"object","required":["agent_id","amount_usdc","purpose"],"properties":{"purpose":{"type":"string","maxLength":120,"minLength":2},"agent_id":{"type":"string","maxLength":128,"minLength":1},"amount_usdc":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$"},"idempotency_key":{"type":"string","maxLength":128},"recipient_risk_level":{"enum":["LOW","MEDIUM","HIGH","SEVERE"],"type":"string"}}}},"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":"nomos-payment-preflight","assessment":{"flags":[],"risk_level":"low","risk_score":0}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","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.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Jr7-ZVwftHspyt8AFWNQ4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Evaluates an autonomous agent's proposed USDC payment before execution, returning a risk score, risk level, and any compliance flags.","exampleAgentPrompt":"Before my agent sends 25.50 USDC to fulfill a vendor contract, run a Nomos payment preflight check for agent ID 'agent-xyz-001' with purpose 'vendor-invoice-payment' and flag it if the recipient risk level is HIGH.","exampleUseCases":[{"title":"Agent payment safety gate","prompt":"My trading agent wants to send 100 USDC to a new counterparty — run a preflight risk check for agent ID 'trader-agent-007', amount 100 USDC, purpose 'market-maker-settlement', and let me know if the risk score is too high to proceed."},{"title":"Compliance screening for payroll agent","prompt":"Before my payroll agent disburses 500 USDC to a contractor, screen the payment using agent ID 'payroll-bot-003' with purpose 'contractor-payment' and recipient risk level MEDIUM so I know if there are any compliance flags."},{"title":"Low-value micropayment preflight","prompt":"My content agent is about to pay 0.50 USDC for an API call — do a quick Nomos preflight check for agent ID 'content-agent-12', amount 0.50, purpose 'data-api-access', so we can confirm risk is low before it executes."}],"resultDescription":"Returns a JSON object containing the Base network identifier (eip155:8453), product name, and an assessment object with risk_score (numeric), risk_level (e.g. 'low', 'medium', 'high'), and a flags array listing any detected compliance or risk issues. May also include identity, activity, and provenance sub-objects for deeper analysis.","failureModes":["Missing required query params (agent_id, amount_usdc, purpose) returns 400 validation error","Invalid amount_usdc format (non-numeric or >6 decimal places) causes schema rejection","Unknown or unsupported recipient_risk_level enum value returns validation error","Payment of $0.20 USDC not completed triggers 402 Payment Required before assessment is returned","Downstream risk engine unavailable may return 503 or empty assessment","idempotency_key collision with different parameters may return cached or conflicting response"],"whenToPreferThis":"Use this endpoint when an autonomous agent needs a decision gate before executing a USDC payment on Base — especially when the payment is to an unknown or variable-risk recipient, or when compliance evidence is required before disbursement. Prefer this over generic on-chain analytics when you need a structured risk_score + flags output specifically designed for agent-to-agent or agent-to-vendor payment flows, and when you want an auditable preflight record tied to a specific agent_id.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:59:07.393Z","isFirstParty":false}