Polymarket Widget

The Polymarket widget brings the full Polymarket (opens in a new tab) prediction-market experience into the terminal. Browse thousands of event markets, trade YES/NO outcomes, manage positions, and withdraw — all without leaving your workspace.

What It Is

Polymarket is a decentralized prediction-market platform running on Polygon. Every market settles to one of two outcomes (typically YES or NO). You buy shares at a price between $0.00 and $1.00 that represents the current implied probability; each winning share pays out $1.00 on resolution.

The widget wraps Polymarket's public CLOB (Central Limit Order Book) and Gamma APIs, plus on-chain order signing through your terminal wallet.

Prerequisites

You need:

1. An EVM terminal wallet unlocked (Terminal Wallets)
2. USDC.e on Polygon for trading
3. A small amount of POL (Polygon native gas token) for approvals and withdrawals

Funding With USDC.e

You can bridge into USDC.e from any major chain:

• Across (opens in a new tab) — fast canonical bridge
• Jumper (opens in a new tab) — aggregates multiple bridges, usually cheapest

When you start the Polymarket widget without sufficient USDC.e, the widget shows a funding guide with your wallet address and deposit instructions (contract address, chain, POL gas requirement).

Browsing Markets

The Market Browser tab is the default view. Markets are organized by category:

Search

Press / or click the search bar to query the full pool of ~8,000 open markets client-side. Matches update as you type.

Infinite Scroll

Markets load in batches of 500 events (~8k+ markets). Scroll to the bottom and a loading spinner pulls the next page automatically.

Favorites

Click the star on any market card to pin it to your Favorites filter. Favorites persist across sessions.

Market Cards

Every card shows at a glance:

• Question — the market headline
• Probability column — current YES implied probability (e.g. 62%) with a bar visualization
• Yes / No quick-trade pills — one-click order entry at the current price; long-press or expand for quickbuy amount presets
• 24h volume — liquidity signal
• End date — always shows the year (e.g. Dec 31, 2026)
• Category and tag badges

Click anywhere on the card to open the Detail Panel.

Market Detail Panel

The detail panel splits into three regions:

Price Chart

Lightweight-charts powered history for every outcome. Multi-outcome markets render all lines stacked on one chart with crosshair labels, time axis, and clean scaling.

Orderbook + Trades

Live CLOB orderbook for the selected outcome, plus a trades feed that can filter to This market or Global (all Polymarket trades).

Order Entry

Place orders directly below the chart:

Quickbuy preset amounts are configurable in Trading Settings (polymarketQuickBuyAmounts).

Approvals

First-time use requires one-time on-chain approvals so the Polymarket exchange contracts can move your USDC.e and conditional token shares. The onboarding stepper walks you through:

1. Approve USDC.e for the Exchange and NegRisk Adapter contracts
2. Approve ERC-1155 conditional tokens for selling positions later

Approvals are batched where possible. The widget waits for transaction confirmation before enabling trading.

Positions & Portfolio

The Positions tab lists every open market you hold shares in:

• Question and outcome (YES / NO)
• Shares owned and average entry price
• Current price and P&L (dollar + percent), colored live via CLOB WebSocket price updates
• Claimable badge when a market has resolved in your favor — click to redeem winnings to USDC.e
• Sell button — pre-fills the order form with a market sell (FAK against best bid) for the held side

Position shares are reconciled against on-chain balances before every sell to catch phantom positions left over from partial fills.

History

Closed trades appear on a dedicated History tab with entry, exit, realized P&L, and timestamp.

P&L Share Card

After closing a position, an auto-opening share card summarizes the trade for copy-paste or screenshot.

Withdraw

Send USDC.e back out of Polymarket to any Polygon address:

1. Click Withdraw in the widget header
2. Enter a destination address (defaults to your terminal wallet, can be edited)
3. Enter an amount or Max
4. Confirm — the widget sends a standard ERC-20 transfer with explicit gas

News Integration

The News Feed can match incoming posts against open Polymarket markets using a keyword resolver. When a post relates to a tradeable market, a compact prediction match bar renders on the news card with:

• Market question and probability
• Inline YES / NO quickbuy pills that route through the widget

Toggle this in News Feed settings → Polymarket matches. Match sensitivity is tunable.

Common Gotchas

• USDC vs USDC.e — Polymarket requires the bridged variant. Native Polygon USDC will not settle. Watch for the widget's warning badge if it detects the wrong token.
• First-time funding delay — your balance and allowance check runs server-side; give it 10–20 seconds after a deposit for the widget to reflect it.
• Market resolution lag — resolved markets can take minutes to hours to post the winning outcome on-chain. Claimable winnings surface only after resolution is finalized.
• Shares round down — order sizes floor to integer shares, and prices to 2 decimals, to match CLOB precision. Small dust is dropped, not kept.
• Funding before first trade — approvals require POL gas. You cannot skip the approval step; the widget blocks order entry until it completes.

Troubleshooting

"Wrong USDC type detected"

You funded with native Polygon USDC instead of USDC.e. Swap it in the Swap widget (Polygon → Polygon) or bridge out and back in.

Orders fail with HMAC 400 / 401

The CLOB requires clock-synced HMAC auth. The widget handles this automatically; if you see recurring auth failures, disconnect and reconnect the wallet from the widget header.

Orderbook empty

A rare API edge case — the widget falls back to REST polling when the WS /book stream returns empty. Wait a few seconds or click the refresh button.

Sell fails with "insufficient balance"

Your on-chain balance disagrees with what the CLOB thinks you hold. The widget will surface the mismatch; usually refreshing positions fixes it. If not, the shares may be locked in an unsettled FOK order — check the order book and cancel if needed.

Related: Swap · Portfolio · Terminal Wallets