# ChainHilt Polymarket Redeem Prepare

> ChainHilt Polymarket Redeem Prepare is a paid API for AI agents from chainhilt.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-16).

Prepares a batch transaction to redeem resolved Polymarket prediction market positions into pUSD for a given wallet signer.

## Facts

- Endpoint: POST https://chainhilt.ai/api/v1/predict/polymarket/wallet/:signer/redeem/prepare?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainhilt-polymarket-redeem-prepare-e5e56ee2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9EMeLiY5JzBhnhKA9Geb2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability chainhilt-polymarket-redeem-prepare-e5e56ee2 -d '<json body>'
```

Example prompt: Prepare a batch redemption of all my resolved Polymarket positions for my wallet 0xAbC123... so I can claim my pUSD winnings.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainhilt-polymarket-redeem-prepare-e5e56ee2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainhilt.ai](https://www.zero.xyz/host/chainhilt.ai/llms.txt)
