{"uid":"cap_xo-_hBhafnLhUyrGbol_S","slug":"x402-accepts-rank-398f2016","name":"X402 Accepts Rank","description":"X402 Accepts Rank: X402 Accepts Rank ranks challenge accepts entries against buyer network and asset preferences from bounded caller-supplied values without an external provider. Call X402 Accepts Rank before paying for or accepting an x402 or agent delivery assembled from caller-supplied challenge and result metadata. Returns contract-specific checks, normalized evidence, mismatch reasons, and an explicit acceptance or rejection status for X402 Accepts Rank as versioned deterministic JSON. Pri…","url":"https://api.delx.ai/api/v1/x402/x402-accepts-rank","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"accepts":{"type":"array","items":{"type":"object","maxProperties":128,"additionalProperties":true},"maxItems":256,"description":"Accepts supplied to X402 Accepts Rank; used only for this bounded calculation and processed in memory without retention."},"preferred_assets":{"type":"array","items":{"type":"string","maxLength":8192},"maxItems":256,"description":"Preferred Assets supplied to X402 Accepts Rank; used only for this bounded calculation and processed in memory without retention."},"preferred_networks":{"type":"array","items":{"type":"string","maxLength":8192},"maxItems":256,"description":"Preferred Networks supplied to X402 Accepts Rank; used only for this bounded calculation and processed in memory without retention."}}},"responseSchema":{"type":"json","example":{"result":{"ranked":[{"asset":"USDC","amount":"1000","network":"eip155:8453"},{"asset":"USDC","amount":"1000","network":"eip155:1"}],"selected":{"asset":"USDC","amount":"1000","network":"eip155:8453"}},"schema":"delx/util-x402-accepts-rank/v1","status":"pass","evidence":{"retained":false,"input_sha256":"68f07fccda032de91280d8721b0b24830cc41f95e6d3cac4b3f05a715109a84b","external_calls":0},"operation":"delivery_contract:x402_accepts_rank"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wGnPG7dBVX3WvW6kn-F13","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks x402 challenge accepts entries against buyer network and asset preferences, returning a normalized acceptance or rejection verdict with mismatch reasons.","exampleAgentPrompt":"Before I pay this x402 challenge, rank these accepts against my preferred assets (USDC) and networks (base, ethereum) so I know which one to accept and if there are any mismatches.","exampleUseCases":[{"title":"Selecting best x402 accept before paying","prompt":"I have three accepts from this x402 challenge — can you rank them against my preferred assets USDC and ETH on Base and tell me which one I should go with, and flag any mismatches?"},{"title":"Rejecting incompatible payment networks","prompt":"Check these x402 accepts and let me know if any of them match my preferred network (Base mainnet) and asset (USDC) — I only want to accept ones that fully match, reject anything else."},{"title":"Agent delivery pre-payment validation","prompt":"Before my agent pays for this delivery, rank the supplied x402 accepts against preferred assets USDC and networks base and polygon, and return the acceptance or rejection status with any mismatch reasons."}],"resultDescription":"Returns versioned deterministic JSON containing contract-specific checks, normalized evidence for each accept entry, explicit mismatch reasons, a ranked score per entry, and an overall acceptance or rejection status — all computed in-memory from caller-supplied values with no external calls or data retention.","failureModes":["Accepts array exceeds 256 items — request rejected","Individual accept object exceeds 128 properties — validation error","preferred_assets or preferred_networks items exceed 8192 character limit","Malformed accept objects cause schema validation failure","Empty accepts array returns no ranked results","Ambiguous or conflicting asset/network preferences may reduce ranking confidence"],"whenToPreferThis":"Use this endpoint when an AI agent or buyer needs a deterministic, bounded ranking of x402 challenge accepts before committing to a payment or accepting an agent delivery. Prefer this over manual inspection when multiple accept entries are present, when network/asset compatibility needs to be verified programmatically, or when you need an explicit mismatch explanation without relying on an external oracle or provider.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:06:47.630Z","isFirstParty":false}