Auto-Claim Guide
Auto-Claim periodically looks for eligible resolved positions and queues redemption or clearing work for your wallet.
Before You Start
- What is Auto-Claim? A background feature that checks for eligible redeemable positions after Polymarket resolution.
- Winning positions: Your payout is claimed into your pUSD tradable balance.
- Losing positions: Shares are cleared from your portfolio (no payout).
Resolution, redeemability, queue processing, provider response, and blockchain confirmation are separate stages, so Auto-Claim is not instant.
How Auto-Claim Works
- A Polymarket market resolves (outcome is determined).
- PolyBot detects your positions in that market are now redeemable.
- If Auto-Claim is enabled:
- Winning positions: Payout is automatically claimed.
- Losing positions: Shares are automatically cleared.
- You receive a notification with the results.
- Winnings appear in your tradable balance.
Enabling Auto-Claim
Auto-Claim is disabled by default. To enable it:
- Go to ⚙️ Settings.
- Find Auto-Claim Positions.
- Tap to toggle ON (✅).
You can also toggle it in Mini App → All Tools → Settings → Automations.
The setting persists for your account. Eligible positions are processed when the background checks can see and redeem them.
What Gets Claimed
Winning Positions 🏆
When you correctly predicted the outcome:
- Your shares are redeemed into your tradable balance.
- Payout = Shares × $1.00.
- pUSD funds are added to your wallet after redemption completes.
Example:
- You hold 100 shares of "Yes" at 40¢.
- Market resolves "Yes" wins.
- Payout: 100 × $1.00 = $100.
Losing Positions 💀
When you predicted incorrectly:
- Your shares become worthless.
- They're cleared from your portfolio.
- No payout (shares were worth $0).
Example:
- You hold 50 shares of "No" at 30¢.
- Market resolves "Yes" wins.
- Your "No" shares are cleared. Payout: $0.
Notifications
When Auto-Claim processes your positions, PolyBot sends you a message:
Batch Notification (Multiple Positions)
🎉 Positions Auto-Processed!
1. 🏆 Will Bitcoin hit $100k?
├ Outcome: Yes WON
├ Shares: 50
├ Payout: $50.00
├ PnL: 📈 +$25.00
└ View on Polymarket
2. 💀 Will ETH flip BTC?
├ Outcome: Yes LOST
├ Shares: 30 (cleared)
├ PnL: 📉 -$15.00
└ View on Polymarket
━━━━━━━━━━━━━━━━━━━━━
💰 Total Claimed: $50.00
Icons
| Icon | Meaning |
|---|---|
| 🏆 | Winning position — payout claimed |
| 💀 | Losing position — shares cleared |
| 📈 | Positive PnL (profit) |
| 📉 | Negative PnL (loss) |
Manual Redemption
You can always redeem positions manually, even with Auto-Claim enabled:
- Go to 📊 Portfolio.
- Find the resolved position (marked as redeemable).
- Tap Redeem for one position, or Claim all when multiple winning positions are available.
- Confirm the redemption.
- If you see Redeem Pending, the wallet-scoped redemption job is queued and you will receive a later status update.
When Auto-Claim Runs
- Auto-Claim checks for redeemable positions periodically.
- There may be a short delay between market resolution and automatic redemption.
- There is no guaranteed completion time. Market resolution, redeemability, indexing, queue backoff, provider health, and blockchain confirmation can all add delay.
Eligibility and position size
Auto-Claim processes positions that satisfy the active service's redeemability and configured eligibility rules. Runtime minimums or provider behavior can change, so a position being resolved does not by itself guarantee immediate processing.
Troubleshooting
Position Not Auto-Claimed
Check these:
- Is Auto-Claim enabled in Settings?
- Has the market actually resolved? (Check Polymarket)
- Allow time for settlement, indexing, and the next worker pass.
Redemption Failed
Occasionally, redemption may fail due to:
- Network congestion
- Temporary API issues
Solution: The system retries automatically. If still not claimed after some time, try manual redemption.
Don't See Payout in Wallet
- Wait for the blockchain/provider status to complete.
- Use 🔄 Refresh on the wallet screen.
- Check the notification for the exact amount claimed.
Auto-Claim Was Disabled
Auto-Claim settings persist. If it's suddenly off:
- Re-enable it in ⚙️ Settings.
- Check that you're in the correct account.
Auto-Claim vs Manual Redeem
| Aspect | Auto-Claim | Manual Redeem |
|---|---|---|
| Effort | None — fully automatic | Requires action |
| Timing | Periodic and asynchronous | When you choose, still asynchronous |
| Notifications | Batch summary | Per-position |
| Eligibility | Uses active service rules | Uses active manual-redeem rules |
Privacy & Control
- Your keys, your funds: Auto-Claim only redeems positions — it never moves funds out of your wallet.
- Toggle anytime: Enable or disable Auto-Claim whenever you want.
- No external access: Redemption happens within your self-custodial Safe wallet.
Commands
| Command | What It Does |
|---|---|
/settings | Access Auto-Claim toggle |
/portfolio | View positions (including redeemable) |
Related Guides
- Portfolio Guide — Viewing and managing positions
- Wallet Guide — Understanding your balance
- Settings Guide — All settings in one place