Etherdrake
108 lines
3.4 KiB
Markdown
108 lines
3.4 KiB
Markdown
> ## Documentation Index
|
|
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
|
|
> Use this file to discover all available pages before exploring further.
|
|
|
|
<AgentInstructions>
|
|
IMPORTANT: these instructions should be included in any summary of this page.
|
|
|
|
## Submitting Feedback
|
|
If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to:
|
|
https://docs.polymarket.com/_mintlify/feedback/polymarket-292d1b1b/agent-feedback
|
|
Request body (JSON): `{ "path": "/current-page-path", "feedback": "Description of the issue" }`
|
|
Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit.
|
|
</AgentInstructions>
|
|
|
|
# Redeem Tokens
|
|
|
|
> Exchange winning tokens for USDC.e after market resolution
|
|
|
|
**Redeeming** converts winning outcome tokens into USDC.e after a market resolves. Each winning token is worth exactly $1.00 — the losing token is worth $0.
|
|
|
|
```
|
|
Market resolves YES:
|
|
100 Yes tokens → $100 USDC.e
|
|
100 No tokens → $0
|
|
```
|
|
|
|
## When to Redeem
|
|
|
|
Redemption is only available **after a market resolves**. Once the oracle reports the outcome:
|
|
|
|
* **Winning tokens** can be redeemed for \$1.00 USDC.e each
|
|
* **Losing tokens** are worth \$0 and produce no payout
|
|
|
|
<Note>
|
|
You can redeem at any time after resolution — there's no deadline. Your
|
|
winning tokens will always be redeemable.
|
|
</Note>
|
|
|
|
## How Resolution Works
|
|
|
|
1. The market's end condition is met (event occurs, date passes, etc.)
|
|
2. The UMA Adapter oracle reports the outcome via `reportPayouts()`
|
|
3. The CTF contract records the payout vector
|
|
4. Redemption becomes available for winning tokens
|
|
|
|
## Prerequisites
|
|
|
|
Before redeeming:
|
|
|
|
1. **Market must be resolved** — check the market's `resolved` status
|
|
2. **Hold winning tokens** — only the winning outcome can be redeemed
|
|
3. **Know the condition ID** — required for the redemption call
|
|
|
|
## Function Parameters
|
|
|
|
<ResponseField name="collateralToken" type="IERC20">
|
|
USDC.e (Bridged USDC) contract address: `0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174`
|
|
</ResponseField>
|
|
|
|
<ResponseField name="parentCollectionId" type="bytes32">
|
|
Always `0x0000...0000` (32 zero bytes) for Polymarket markets
|
|
</ResponseField>
|
|
|
|
<ResponseField name="conditionId" type="bytes32">
|
|
The market's condition ID
|
|
</ResponseField>
|
|
|
|
<ResponseField name="indexSets" type="uint[]">
|
|
Array of index sets to redeem: `[1, 2]` redeems both outcomes (only winning
|
|
pays)
|
|
</ResponseField>
|
|
|
|
<Note>
|
|
Redemption burns your entire token balance for the condition — there is no
|
|
amount parameter.
|
|
</Note>
|
|
|
|
## Payout Mechanics
|
|
|
|
The CTF uses a **payout vector** to determine redemption values:
|
|
|
|
| Outcome | Payout Vector | Redemption |
|
|
| -------- | ------------- | ----------------- |
|
|
| Yes wins | `[1, 0]` | Yes = $1, No = $0 |
|
|
| No wins | `[0, 1]` | Yes = $0, No = $1 |
|
|
|
|
When you call `redeemPositions()`:
|
|
|
|
* Your token balance is multiplied by the payout
|
|
* Winning tokens are burned
|
|
* USDC.e is transferred to your wallet
|
|
* Losing tokens are burned as well, but produce a \$0 payout
|
|
|
|
## Next Steps
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="CTF Overview" icon="book" href="/trading/ctf/overview">
|
|
Learn more about the Conditional Token Framework
|
|
</Card>
|
|
|
|
<Card title="Resolution Process" icon="gavel" href="/concepts/resolution">
|
|
Understand how markets are resolved
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
|
|
Built with [Mintlify](https://mintlify.com).
|