Polymarket Redeem API (2026): How to Redeem Winning Positions

When can you redeem a Polymarket position?

As soon as the market resolves. Polymarket resolves markets through the UMA Optimistic Oracle: someone proposes an outcome, a two-hour challenge period follows, and the market resolves if nobody disputes it. A dispute starts another round, so a contested market can take longer. You can check where a market stands in its resolution data before trying.

Once resolved, each winning token returns 1 pUSD and each losing token returns 0. In the rare case of a 50-50 resolution, every token redeems for $0.50. There is no deadline: winning tokens stay redeemable at any time after resolution.

How do you redeem with the Polymarket SDK?

Use the unified TypeScript SDK, @polymarket/client, with a secure client authorized by a Relayer API key or a Builder API key, so the redemption runs as a gasless transaction:

import { createSecureClient, relayerApiKey } from '@polymarket/client';
import { privateKey } from '@polymarket/client/viem';

const client = await createSecureClient({
  signer: privateKey(process.env.SIGNER_PRIVATE_KEY),
  wallet: process.env.POLYMARKET_WALLET_ADDRESS,
  apiKey: relayerApiKey({
    key: process.env.POLYMARKET_RELAYER_API_KEY!,
    address: process.env.POLYMARKET_RELAYER_API_KEY_ADDRESS!,
  }),
});

const transaction = await client.redeemPositions({ conditionId: '0xYourMarketConditionId' });
const outcome = await transaction.wait();
console.log(outcome.transactionHash);

The Python SDK, polymarket-client, has the same method on its async and sync secure clients:

import os
from polymarket import AsyncSecureClient, RelayerApiKey

client = await AsyncSecureClient.create(
    private_key=os.environ["SIGNER_PRIVATE_KEY"],
    wallet=os.environ["POLYMARKET_WALLET_ADDRESS"],
    api_key=RelayerApiKey(
        key=os.environ["POLYMARKET_RELAYER_API_KEY"],
        address=os.environ["POLYMARKET_RELAYER_API_KEY_ADDRESS"],
    ),
)

transaction = await client.redeem_positions(condition_id="0xYourMarketConditionId")
outcome = await transaction.wait()
print(outcome.transaction_hash)

Relayer and Builder API keys, and how gasless transactions work, are explained in the Polymarket relayer API guide.

How do you redeem through the API without the SDK?

You build the contract call yourself, then send it through the relayer. The target is the collateral adapter that matches the market's negRisk flag:

ABI-encode a call to redeemPositions(address collateralToken, bytes32 parentCollectionId, bytes32 conditionId, uint256[] indexSets) with these arguments:

For a Deposit Wallet, put that call into a signed wallet batch and submit it to the relayer:

curl -X POST "https://relayer-v2.polymarket.com/submit" \
  -H "Content-Type: application/json" \
  -H "RELAYER_API_KEY: $RELAYER_API_KEY" \
  -H "RELAYER_API_KEY_ADDRESS: $RELAYER_API_KEY_ADDRESS" \
  --data '{
    "type": "WALLET",
    "from": "<signer_address>",
    "to": "0x00000000000Fb5C9ADea0298D729A0CB3823Cc07",
    "nonce": "<wallet_nonce>",
    "signature": "<wallet_batch_signature>",
    "metadata": "Redeem positions",
    "depositWalletParams": {
      "depositWallet": "<deposit_wallet_address>",
      "deadline": "<unix_seconds>",
      "calls": [{ "target": "<collateral_adapter_address>", "value": "0", "data": "<encoded_redeem_calldata>" }]
    }
  }'

Why did my Polymarket redeem fail?

Work through these checks in order. Each one matches a requirement in Polymarket's own redemption steps:

1. The market has not resolved yet. A proposal in its two-hour challenge period, or a disputed one, is not a resolution. Wait for the final result.
2. The adapter is not approved. The collateral adapter must be approved to move your outcome tokens, through setApprovalForAll on the Conditional Tokens contract, before it can redeem them.
3. The wrong adapter. Negative risk markets need the NegRiskCtfCollateralAdapter. The SDK chooses for you, so this mostly affects hand-built calls.
4. The tokens are in another wallet. Most accounts hold positions in a proxy or deposit wallet, not the signing key. Redeem from the wallet that holds the tokens, found as explained in how to find your Polymarket proxy wallet.
5. The transaction has not confirmed. A relayer submission is not final until it reaches STATE_CONFIRMED.
6. There was nothing to redeem. Losing tokens return 0 pUSD, so redeeming only the losing side of a market moves no money.

Because winning tokens never expire, nothing is lost by fixing the cause and trying again later.

How do you find positions that are ready to redeem?

Polymarket's Data API returns positions for any wallet with a redeemable flag, as covered in the Polymarket Data API guide. If the same wallet also trades on other venues, the Predictefy API values its positions across all of them in one call, with each position's status:

import { Predictefy } from '@predictefy/sdk';

const client = new Predictefy({ apiKey: process.env.PREDICTEFY_API_KEY });

const portfolio = await client.fetchPortfolio({ address: '0xYourWalletAddress' });
for (const [venue, v] of Object.entries(portfolio.venues)) {
  for (const p of v.positions.data ?? []) {
    if (p.status === 'resolved' && (p.size ?? 0) > 0) console.log(venue, p.marketId, p.side, p.size);
  }
}

Frequently Asked Questions