withdrawal-floor: Full Guide to the Free Polymarket Withdrawal Calculator CLI

The withdrawal-floor CLI answers the question your balance number can’t: how much can I actually withdraw right now? This is the author’s full guide — every output line decoded, the workflow that makes the numbers actionable, and the automation for ongoing accounts. (Quick intro in the tools overview; the math is in the withdrawable-amount guide.)

What does withdrawal-floor actually compute?

Four numbers from your public positions — no wallet connection, no keys: locked value (capital in unresolved positions — it can’t fund a withdrawal until its market resolves), redeemable wins (resolved markets you haven’t claimed), the 10% floor (the platform’s holdback against total portfolio value, settled after your positions resolve), and withdrawable now — what remains after all three. The subtraction chain and why each bucket exists: the full guide.

Reading the output, line by line

Address            : 0xabc...
Open positions     : 4 (value $1,240.50) — locked until resolution
Redeemable wins    : 2 (value $310.00)
10% floor          : $155.05
Withdrawable now   : $154.95

• Open positions — the locked bucket. Not lost: winners redeem at $1.00, losers at $0.00 — but until resolution, this capital is out of reach (see multi-outcome positions for how baskets display here).
• Redeemable wins — the cheapest money on the table. Claim these first: claiming adds to withdrawable and reduces the floor’s base (unclaimed wins still count in total value).
• 10% floor — scales with your whole portfolio; it shrinks as positions resolve. Don’t plan cash-out dates around your full balance — see minimum-amounts economics.
• Withdrawable now — the honest number for withdrawal planning.

The redemption-first workflow

Before any planned withdrawal: 1. Run the tool — see the buckets. 2. Redeem every claimable win (platform-side, one click each — gasless for most flows; see gas notes). 3. Re-run the tool — the floor recalculated on the new total; your withdrawable number moved. 4. Check locked positions’ resolution dates — if a big bucket resolves within your planning horizon, waiting may double the withdrawable number without new capital (see exit-timing discipline). 5. Then withdraw once — batched, per the timelines guide.

Automating it

A weekly (or post-resolution) cron line keeps the picture current:

0 9 * * 1 cd ~/withdrawal-floor && python3 withdrawal_floor.py \
  --address 0xYourWallet >> ~/withdrawable_log.txt

The log becomes your floor-history: watch how the locked bucket decays as markets resolve, and how the withdrawable number responds to redemption sweeps. Pair the log with the PnL attribution discipline — locked capital that never resolves (dead markets) is a cost line worth seeing. The interactive version with the same formulas (browser, clicks instead of commands) lives at my HuggingFace calculator.

FAQ

Is withdrawal-floor free and safe? Yes — MIT, read-only, standard library. It reads your public positions; no wallet connection, no keys, no signature ever. Nothing to leak.

Why does the tool show less than my app balance? The app shows total value; withdrawal reality subtracts locked positions, unclaimed wins, and the 10% floor. Both are true — only one is spendable: see the subtraction chain.

Does claiming wins change the floor? Yes — claiming converts wins into claimable capital and shrinks the floor’s base (unclaimed wins count in total value). Redeem first, re-run the tool second: the workflow above sequences it.

How current are the numbers? Snapshot-of-when-you-ran-it: resolution waves move the buckets — re-run after every settlement batch, or cron it weekly for a trend record.

Does it work for US-app accounts? The tool reads public on-chain positions (global-platform structure); US-app balances live behind regulated rails — use the app’s funding section there, and the US experience guide for the operational differences.

Educational tool guide, not financial advice. Not affiliated with Polymarket. Last updated October 2026.