{"uid":"cap_f2YJJl03LTHcosuTZtwno","slug":"lumi-trust-x402-url-safety-check-e2faa77e","name":"Lumi Trust x402 URL Safety Check","description":"Pre-payment check for an x402 resource URL: allow, warn or block with coded reasons. Built from a daily index of the CDP Bazaar catalog, unpaid 402-quote checks and Lumi's own on-chain test purchases on Base, the XRP Ledger and Stellar. Optional payTo and amount inputs catch address or price mismatches. A free signed version, Lumi Check, is at /v1/check. Observations, not a guarantee.","url":"https://api.lumitrades.io/v1/trust/check?utm_source=zero.xyz","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":["url"],"properties":{"url":{"type":"string","description":"The x402 resource URL you are about to pay (required)"},"payTo":{"type":"string","description":"The payTo address from its 402 quote (optional)"},"amount":{"type":"string","description":"The quoted price in USD, e.g. 0.01 (optional)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["kind","payment"],"properties":{"kind":{"type":"string"},"as_of":{"type":"string"},"query":{"type":"object"},"payment":{"type":"object"},"reasons":{"type":"array"},"verdict":{"type":"string"},"confidence":{"type":"string"},"next_steps":{"type":"object"},"next_update":{"type":"string"},"stale_after":{"type":"string"},"data_age_seconds":{"type":"number"}}}},"description":"Errors: 400 invalid_input; 402 payment_required; 409 idempotency_conflict | settlement_status_unknown; 429 rate_limited; 500 internal_error; 502 invalid_verify_response | settle_http_error; 503 stale_data | data_unavailable | facilitator_unavailable. Details: GET /openapi.json (responses) or /.well-known/x402 (errors)."}}},"responseSchema":{"type":"json","example":{"kind":"trust_check","as_of":"2026-10-23T11:00:00Z","query":{"url":"https://api.example.com/v1/data","payTo":"0x12ab...89cd"},"payment":{"asset":"USDC","payer":"0x12ab...89cd","amount":"0.02","network":"eip155:8453","transaction":"0x5f0c...e41a"},"reasons":[{"code":"last_quote_invalid","detail":"Lumi's last free quote check did not get a valid x402 quote.","severity":"warn"}],"verdict":"warn","confidence":"low","next_steps":{"free_lookup":"https://api.lumitrades.io/v1/trust/vendors?url=..."},"next_update":"2026-10-23T17:00:00Z","stale_after":"2026-10-24T11:00:00Z","data_age_seconds":600}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-edc1sg0SKHwiVtY0xQ0j","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether an unfamiliar x402 payment URL is safe to pay by returning an allow/warn/block verdict with reasons, based on Lumi's daily CDP Bazaar index and probe data.","exampleAgentPrompt":"Before you pay that x402 URL https://api.example.com/v1/data, run a Lumi Trust check on it — the quote said payTo 0x12ab...89cd for $0.01, so pass those along too so we can catch any address or price mismatch.","exampleUseCases":[{"title":"Pre-payment safety gate for agent","prompt":"I'm about to let my agent pay https://api.somevendor.com/v1/report — the 402 quote said payTo 0xABCD...1234 for $0.005. Can you run a Lumi Trust check on it first so I know if it's safe?"},{"title":"Price mismatch detection","prompt":"The x402 URL https://api.newservice.io/data is quoting me $0.10 but I expected $0.01 — check it against Lumi Trust with that price and payTo 0x9988...7766 so I can see if something's off."},{"title":"Unknown vendor vetting","prompt":"I've never used https://api.unknownprovider.com/signals before and it's asking for a payment — can you do a Lumi Trust check on that URL before I authorize anything?"}],"resultDescription":"A JSON object with a verdict field ('allow', 'warn', or 'block'), a confidence level, a list of reason objects (each with a code, detail, and severity), the query echoed back, payment metadata, an as_of timestamp, and a stale_after time indicating when the data expires. Also includes a next_steps object with links for further lookup.","failureModes":["Bad or missing URL input — not charged, returns error","payTo address format mismatch — returns warn with reason code","Stale index data — confidence may be 'low' with older as_of timestamp","Unknown URL not yet indexed — may return low-confidence warn rather than definitive verdict","Network or upstream API failure — generic error response"],"whenToPreferThis":"Use this endpoint whenever an AI agent is about to pay an x402 URL it has not previously used or verified, especially when the payTo address or quoted price is unknown. It is the only service that cross-references the CDP Bazaar index and performs live probe checks specifically for x402 URLs, making it uniquely suited for pre-payment safety screening in agentic payment flows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:41:10.257Z","isFirstParty":false,"canonicalSlug":"lumi-trust-x402-url-safety-check-e2faa77e"}