General
What is Polymarket Perps?
What is Polymarket Perps?
Which instruments can I trade?
Which instruments can I trade?
GET /v1/info/instruments.Is the exchange on-chain or off-chain?
Is the exchange on-chain or off-chain?
Does the perp trade 24/7, even when the underlying market is closed?
Does the perp trade 24/7, even when the underlying market is closed?
Do Polymarket Perps expire?
Do Polymarket Perps expire?
Are perps and perpetual futures the same thing?
Are perps and perpetual futures the same thing?
How are Perps different from Polymarket prediction markets?
How are Perps different from Polymarket prediction markets?
Trading and Orders
What order types are supported?
What order types are supported?
gtc, ioc, and fok time-in-force values. GTC orders can be tagged post-only, which rejects the order if it would take liquidity. Closing orders can be tagged reduce-only, which prevents the order from increasing exposure. See Configure Order Behavior and Close a Position.Why was my order rejected when my balance looks fine?
Why was my order rejected when my balance looks fine?
Equity < IM_required for that worst case, the order is rejected even though current equity is comfortable.What is self-trade prevention?
What is self-trade prevention?
Pricing, Mark, Index, and Funding
What's the difference between Mark Price, Index Price, and last trade price?
What's the difference between Mark Price, Index Price, and last trade price?
- Index Price is the protocol’s estimate of the underlying’s fair value, aggregated from external oracle feeds.
- Mark Price is the price the system uses for margin, PnL, liquidation, and funding.
- Last trade price is the price of the most recent fill on the local book. It is not used for margining.
What happens to Mark when external feeds go down?
What happens to Mark when external feeds go down?
How is funding calculated and when does it settle?
How is funding calculated and when does it settle?
Can I see funding pressure between settlements?
Can I see funding pressure between settlements?
GET /v1/info/funding.Margin and Leverage
What's the difference between cross and isolated margin?
What's the difference between cross and isolated margin?
- Isolated margin funds each position with a dedicated margin allocation. Liquidation only closes the affected position.
- Cross margin shares account collateral across all cross positions. Unrealized PnL on one position can offset margin on another, but a liquidation evaluates and can unwind the whole cross account.
What are leverage tiers and why does my margin go up as my position grows?
What are leverage tiers and why does my margin go up as my position grows?
GET /v1/info/instruments.Why is maintenance margin always half of initial margin?
Why is maintenance margin always half of initial margin?
What happens between margin call and liquidation?
What happens between margin call and liquidation?
| State | Condition | Behavior |
|---|---|---|
| Healthy | Equity >= IM | Normal trading |
| Margin call | MM <= Equity < IM | Reduce-only: close exposure or deposit collateral |
| Liquidation | Equity < MM | System closes the position |
Can I withdraw collateral while I have an open position?
Can I withdraw collateral while I have an open position?
Equity_after >= IM_required after the withdrawal. You cannot withdraw yourself into a margin call.Liquidation
When am I liquidated?
When am I liquidated?
Why does my liquidation price move when I haven't changed anything?
Why does my liquidation price move when I haven't changed anything?
What happens during liquidation?
What happens during liquidation?
What is the insurance fund and when does it step in?
What is the insurance fund and when does it step in?
Are there extra fees on liquidation fills?
Are there extra fees on liquidation fills?
GET /v1/info/instruments.Fees
What are the current maker and taker fees?
What are the current maker and taker fees?
| Role | Rate |
|---|---|
| Maker | -0.5 bp (rebate) |
| Taker | 2 bp |
abs(Price * Quantity) * Rate, denominated in the instrument’s quote asset. After launch, the platform will move to a tiered structure based on volume and maker share. Details will be published before the transition. See Trading Fees.API and Integration
What's the difference between my main wallet and the proxy?
What's the difference between my main wallet and the proxy?
(proxy, secret) pair authenticates private REST and WebSocket reads. This isolates the trading key from the wallet that holds funds. See Set Up Authentication.What address identifies my Perps account?
What address identifies my Perps account?
createProxy, not a Safe smart-contract wallet address. Even if
you use a Safe wallet elsewhere on Polymarket, your Perps balances, positions,
and history are all tracked against the underlying EOA. Use that EOA when
looking up your account or referencing it in support requests.Which requests need a signature vs. just headers?
Which requests need a signature vs. just headers?
- Signed requests with
sig,salt, andts:POST /account/key, all/trade/*actions, andPATCH /trade/leverage. The signer is the main address forcreateProxyand the proxy address for everything else. - Header credentials with
POLYMARKET-PROXYandPOLYMARKET-SECRET: private/account/*reads. - WebSocket authentication: send a single
authmessage after connecting, then subscribe to private channels.
How do I avoid clock-skew rejections?
How do I avoid clock-skew rejections?
ts request timestamp in
milliseconds and salt. Reused or stale values are rejected. Sync against
GET /v1/info/time and do not sign requests far in the past or future. The
optional expa field caps the validity window.How do deposits and withdrawals work?
How do deposits and withdrawals work?
Equity_after >= IM_required. See Fund Your Account.Are there geographic restrictions on order placement?
Are there geographic restrictions on order placement?
Sessions
What do market sessions actually change?
What do market sessions actually change?
What's the difference between Disrupted and Halted?
What's the difference between Disrupted and Halted?
- Disrupted means external feeds are unavailable or failing sanity checks. The system falls back to whatever feed set is still healthy.
- Halted means the underlying itself has a trading halt or corporate-action freeze.