Skip to main content

Auto-Claim Guide

Automatically redeem your winning positions when markets resolve. No manual action needed — your winnings are claimed for you.

Before You Start

  • What is Auto-Claim? A feature that automatically redeems your positions when Polymarket markets resolve.
  • Winning positions: Your payout is claimed into your pUSD tradable balance.
  • Losing positions: Shares are cleared from your portfolio (no payout).
Set It and Forget It

Enable Auto-Claim once and never worry about missing a redemption. Your winnings are automatically collected when markets settle.


How Auto-Claim Works

  1. A Polymarket market resolves (outcome is determined).
  2. PolyBot detects your positions in that market are now redeemable.
  3. If Auto-Claim is enabled:
    • Winning positions: Payout is automatically claimed.
    • Losing positions: Shares are automatically cleared.
  4. You receive a notification with the results.
  5. Winnings appear in your tradable balance.

Enabling Auto-Claim

Auto-Claim is disabled by default. To enable it:

  1. Go to ⚙️ Settings.
  2. Find Auto-Claim Positions.
  3. Tap to toggle ON (✅).

Screenshot

That's it! All future resolved positions will be claimed automatically.


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

IconMeaning
🏆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:

  1. Go to 📊 Portfolio.
  2. Find the resolved position (marked as redeemable).
  3. Tap Redeem for one position, or Claim all when multiple winning positions are available.
  4. Confirm the redemption.
  5. 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.
  • Typical timing: Within minutes of market resolution.

Small Position Filtering

All redeemable positions are eligible for Auto-Claim.


Troubleshooting

Position Not Auto-Claimed

Check these:

  1. Is Auto-Claim enabled in Settings?
  2. Has the market actually resolved? (Check Polymarket)
  3. Wait a few minutes — there can be a short delay.

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

  1. Wait 1-2 minutes for the blockchain to confirm.
  2. Use 🔄 Refresh on the wallet screen.
  3. Check the notification for the exact amount claimed.

Auto-Claim Was Disabled

Auto-Claim settings persist. If it's suddenly off:

  1. Re-enable it in ⚙️ Settings.
  2. Check that you're in the correct account.

Auto-Claim vs Manual Redeem

AspectAuto-ClaimManual Redeem
EffortNone — fully automaticRequires action
TimingShortly after resolutionWhen you choose
NotificationsBatch summaryPer-position
Small positionsEligibleCan redeem manually

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

CommandWhat It Does
/settingsAccess Auto-Claim toggle
/portfolioView positions (including redeemable)