{"uid":"cap_1X-Bp4kXsslok2SFPo7ZK","slug":"tollex-x402-payment-requirements-lookup-3800e18f","name":"Tollex x402 Payment Requirements Lookup","description":"Tollex lets software agents buy APIs and tools under rules you set: it finds a capability that fits, checks your policy before anything is signed, pays with x402 in USDC on Base or USDG on Robinhood Chain, reconciles uncertain payments and returns a signed receipt.","url":"https://api.tollex.org/tools/x402_get_requirements?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","pattern":"^https?://","examples":["https://merchant.example/v1/quote"],"maxLength":2048}}},"responseSchema":{"type":"json","example":{"tool":{"id":"x402_get_requirements","version":"1.0.0","provider":"tollex.robinhood-chain"},"result":{"accepts":[{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","amount":"10000","scheme":"exact","network":"eip155:8453","maxTimeoutSeconds":300}],"fetchedAt":"2026-10-11T08:00:00.000Z","acceptsHash":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036"},"evidence":[],"untrustedOutput":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0079","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.0079/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0079","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0079","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UXKf6ZNoI2Tl6w-88Ai2X","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0079","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the x402 payment requirements (price, accepted tokens, network) for a given API endpoint URL before purchasing access","exampleAgentPrompt":"Before we buy access, check what payment terms https://merchant.example/v1/quote requires — I need to know the price, which token it accepts, and which network it runs on.","exampleUseCases":[{"title":"Pre-flight check before buying an API","prompt":"Before my agent pays to call the weather data API at https://api.weathersvc.io/premium/forecast, can you look up what its x402 payment requirements are — price, token, and network?"},{"title":"Comparing costs across multiple tools","prompt":"I want to compare the payment requirements for these two data APIs before deciding which one to buy: check https://api.datasvc-a.com/v1/lookup and tell me the price and accepted tokens."},{"title":"Policy validation before autonomous purchase","prompt":"My agent is about to buy access to https://tools.aiservice.io/v2/analyze — can you first fetch the x402 payment requirements so I can confirm the price is within my spending policy before anything is signed?"}],"resultDescription":"Returns the x402 payment requirements for the specified URL, including the required payment amount, accepted stablecoin token (e.g. USDC on Base or USDG on Robinhood Chain), target network, and any additional payment policy fields needed before initiating a purchase.","failureModes":["URL is not an x402-enabled endpoint — returns no payment requirements or an error","Malformed or unreachable URL — network timeout or connection error","URL exceeds 2048 character limit — validation error","Target merchant server returns unexpected response format — parsing failure","URL does not begin with http:// or https:// — schema validation rejection"],"whenToPreferThis":"Use this endpoint when an agent needs to inspect the payment requirements of an x402-gated API before committing to a purchase — especially to enforce spending policies, compare costs, or determine which token and network a merchant accepts. It is a read-only pre-flight check and should always be called before executing a payment through Tollex.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:47:35.334Z","isFirstParty":false,"canonicalSlug":"tollex-x402-payment-requirements-lookup-3800e18f"}