{"uid":"cap_9EMeLiY5JzBhnhKA9Geb2","slug":"chainhilt-polymarket-redeem-prepare-e5e56ee2","name":"ChainHilt Polymarket Redeem Prepare","description":"Prepare a batch redeeming resolved positions to pUSD; `conditionId` narrows it to one condition. `plan.plan.details.conditions` lists what this batch redeems. Protocol V2 positions go in a batch of their own: when CTF positions are redeemable too, this batch carries those and `plan.plan.details.pendingConditions` lists the V2 conditions for the next prepare. V2 outcomes that pay nothing are skipped. 422 when nothing is redeemable.","url":"https://chainhilt.ai/api/v1/predict/polymarket/wallet/:signer/redeem/prepare?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"conditionId":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"bytes32 condition id to redeem only that market; omit to redeem everything redeemable."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JsKMMi_y5n6saHbtUVnja","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Prepares a batch transaction to redeem resolved Polymarket prediction market positions into pUSD for a given wallet signer.","exampleAgentPrompt":"Prepare a batch redemption of all my resolved Polymarket positions for my wallet 0xAbC123... so I can claim my pUSD winnings.","exampleUseCases":[{"title":"Redeem all resolved market positions","prompt":"My Polymarket positions have resolved — can you prepare a batch redemption for all of them for my wallet 0xAbC123... so I can get my pUSD?"},{"title":"Redeem a specific market condition","prompt":"I want to redeem only the position for Polymarket condition 0xd3f1a2b4c5e6f7890123456789abcdef0123456789abcdef0123456789abcdef01 from my wallet 0xAbC123..."},{"title":"Check V2 redemption plan before signing","prompt":"Can you prepare the redemption plan for my Polymarket wallet 0xAbC123... so I can see which conditions are being redeemed now and which V2 conditions are queued for next?"}],"resultDescription":"Returns a structured redemption batch plan including the list of conditions being redeemed, pUSD amounts, and for Protocol V2 positions, any pending conditions deferred to the next batch. Returns 422 if no positions are currently redeemable.","failureModes":["422 Unprocessable Entity when no positions are redeemable for the given wallet","400 if conditionId is provided but does not match a redeemable condition","Invalid signer address format causes request failure","V2 positions with zero payout are silently skipped and may not appear in plan"],"whenToPreferThis":"Use this endpoint when an AI agent needs to prepare an on-chain redemption transaction for resolved Polymarket prediction market positions without managing API keys, handling CTF batch logic manually, or dealing with V2 vs V1 protocol differences. Prefer over direct on-chain calls when you need a structured plan object before signing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:38:48.098Z","isFirstParty":false,"canonicalSlug":"chainhilt-polymarket-redeem-prepare-e5e56ee2"}