{"uid":"cap_RlgPBqMiXGyu6d35bV59H","slug":"x402oracle-trade-check-a7992e3d","name":"x402Oracle Trade Check","description":"Fast pre-trade check for trading agents: liveness, freshness, and price, payTo, and chain drift.","url":"https://api.x402oracle.com/v1/trade-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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["resource"],"properties":{"resource":{"type":"string","pattern":"^https://","maxLength":2048,"minLength":1,"description":"Absolute https x402 endpoint URL to check before sending payment."},"maxUsdPrice":{"type":"string","description":"Optional non-negative USD price ceiling for the checked endpoint."},"expectedPayTo":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Optional expected receiving wallet address for drift checks."},"maxAgeSeconds":{"type":"string","description":"Optional non-negative integer freshness limit for the trust decision."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"schema":{"type":"object"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"v":1,"chain":{"value":"base-mainnet","distinct":1,"changed24h":false,"changeCount":0,"lastChangeAgeSeconds":null},"payTo":{"value":null,"distinct":0,"changed24h":false,"changeCount":0,"lastChangeAgeSeconds":null},"price":{"usd":0.001,"currency":"USDC","distinct":1,"changed24h":false,"changeCount":0,"lastChangeAgeSeconds":null},"stale":false,"tracked":true,"liveness":{"successRate":0.996,"p95LatencyMs":540,"lastLatencyMs":410,"consecutiveFailures":0},"resource":"https://api.anchor-x402.com/v1/price/token","ageSeconds":78,"observedAt":"2026-06-10T00:00:00.000Z","review_count":0,"review_rating":null,"last_reviewed_at":null,"verified_reviews":0,"freshnessAgeSeconds":30,"has_verified_reviews":false,"weighted_review_rating":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PYh7JVh-4G94hIByMWmBR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a fast pre-trade liveness, freshness, price, payTo address, and chain drift check on an x402 endpoint before committing payment.","exampleAgentPrompt":"Before paying, do a quick x402Oracle trade check on https://api.someservice.com/v1/data — make sure it's live, the price is under $0.05, and the payTo address is 0xAbCd1234567890abcdef1234567890abcdef1234, with freshness no older than 60 seconds.","exampleUseCases":[{"title":"Verify API health before agent payment","prompt":"Quick liveness check on https://market.datafeed.io/v1/ticker — confirm it's responding, price is capped at $0.10, payTo stays 0x742d35Cc6634C0532925a3b844Bc9e7595f3bEb3, and data's fresh within 30 seconds."},{"title":"Detect wallet address tampering on APIs","prompt":"Run a fast pre-trade check on https://api.chaindata.com/v2/balances before my agent calls it — verify the payTo address hasn't drifted from 0x8ba1f109551bD432803012645Ac136ddd64DBA72 and price stays below $0.02."},{"title":"Catch price drift on paid resources","prompt":"Do a quick health scan on https://oracle.pricing.net/v1/quotes — make sure it's live and fresh within 45 seconds, price hasn't jumped above $0.08, and the receiving wallet is still 0x1234567890123456789012345678901234567890."}],"resultDescription":"Returns a trust verdict object indicating whether the x402 endpoint is live, whether its price is within the specified ceiling, whether the payTo wallet address matches expectations, and whether the data is fresh enough — enabling the calling agent to decide safely whether to proceed with payment.","failureModes":["Resource URL is not a valid https x402 endpoint — returns validation error","Target endpoint is unreachable or times out — returns liveness failure","Price exceeds maxUsdPrice ceiling — returns drift alert","payTo wallet address differs from expectedPayTo — returns address drift warning","Response is older than maxAgeSeconds — returns freshness failure","Malformed wallet address pattern in expectedPayTo — returns schema validation error"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a lightweight, low-latency pre-flight check before committing to an x402 micropayment — especially when price drift, wallet address tampering, or stale endpoints are a concern. Prefer this over the full trust verdict endpoint when speed matters and you only need the fast liveness + drift signals rather than full monitoring history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T04:48:50.451Z","isFirstParty":false,"canonicalSlug":"x402oracle-trade-check-a7992e3d"}