{"uid":"cap_898Mcdg2tS74HsnrYqdy5","slug":"halowerk-x402werk-offer-parse-b3069de6","name":"HALOWERK x402werk — Offer Parse","description":"HALOWERK x402werk — bezahlte Endpunkte nach x402. Preise in USDC auf Base Mainnet.","url":"https://x402.netzhandwerker.de/offer/parse","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","pattern":"^https?://","maxLength":2048,"description":"Absolute http or https URL of the paid endpoint whose 402 challenge should be read. Private, loopback and link-local targets are rejected."},"challenge":{"type":"object","description":"A 402 challenge object you already hold, in x402 v1 or v2 form. Use this instead of url when nothing should be fetched."},"timeout_ms":{"type":"integer","default":6000,"maximum":12000,"minimum":1000,"description":"Time budget for fetching the foreign challenge."}}},"responseSchema":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_Q01y7asXUUz5J8iSGJ4MT","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":"Fetches and parses an x402 payment challenge (HTTP 402) from a remote URL or a supplied challenge object, returning structured payment requirement details.","exampleAgentPrompt":"Can you fetch and parse the x402 payment challenge from https://api.example.com/paid-resource and tell me what the price and payment address are?","exampleUseCases":[{"title":"Inspect paywalled API before paying","prompt":"Before I pay anything, can you parse the x402 challenge at https://data.someservice.io/premium-endpoint and tell me exactly how much it costs, which network, and what address to send USDC to?"},{"title":"Decode an in-hand 402 challenge object","prompt":"I already have a 402 challenge object from a previous request — can you parse it and pull out the structured payment details like the price, token, and recipient address?"},{"title":"Audit x402 payment terms on a partner API","prompt":"I need to verify the payment requirements on our partner's API at https://partner.example.com/api/quotes — can you read and parse their x402 offer so I can confirm it's asking for USDC on Base Mainnet at the agreed price?"}],"resultDescription":"A structured object containing the parsed x402 payment challenge fields: protocol version (v1 or v2), required payment amount (in USDC), accepted blockchain network (e.g. Base Mainnet), recipient payment address, and any additional offer metadata extracted from the challenge.","failureModes":["Target URL is private, loopback, or link-local — rejected with a 4xx error","Target URL does not return an x402 (HTTP 402) challenge — parsing fails","Supplied challenge object does not conform to x402 v1 or v2 schema — parse error","Request times out before the remote endpoint responds (timeout_ms exceeded, max 12000ms)","Malformed URL provided (does not match ^https?:// pattern or exceeds 2048 chars)","Remote endpoint is unreachable or returns a non-402 HTTP status"],"whenToPreferThis":"Use this endpoint when an AI agent needs to inspect or understand the payment requirements of an x402-protected endpoint before deciding whether and how to pay. It is the right choice when you have either a URL of a paywalled API or a raw 402 challenge object and need structured payment details (price, network, address, version) extracted without executing any actual payment. Prefer this over attempting to call the paid endpoint directly when you need to audit, display, or route based on payment terms.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:33:51.263Z","isFirstParty":false}