Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Start trading

This page takes you through the web client from nothing to a first trade and back out. It takes about ten minutes. Everything happens on the testnet: the USDC is a test token and nothing here is money.

What you are trading

Each market is one outcome of a Polymarket question, such as "Will it snow in Boston before Dec 1?". Its price is the chance the market gives that outcome, from 0% to 100%. An option here is a bet on where that chance will be at a set time, its expiry (20:00 UTC on the expiry date). A call pays if the chance ends above the option's strike, and a put pays if it ends below. One contract pays $1 for every point past the strike, so a 45¢ call that settles at 60% pays $15. The buyer pays the option's price up front and can lose no more than that. The seller receives that price, and the exchange holds the most the seller could owe from their cash until the position is closed or expires. Options settle in cash at expiry by themselves, so there is nothing to exercise. Contracts has the full terms.

1. Get an account

Your account is a wallet address. There is no username, password or email. You can open one in two ways.
Press CONNECT WALLET at the top right, then Try it now: a testnet account in this browser. The client makes a key in this browser, gets test funds from the faucet, deposits them and enables trading, with nothing for you to sign. The order button shows each step (CREATING ACCOUNT…, GETTING TEST FUNDS…, DEPOSITING…) and then counts down, READY IN ~6s. When the countdown ends you can trade. Skip to step 3.
This is also the way in on a phone, where the browser has no wallet.
The account lives in this browser's storage only. If you clear the browser, the account is gone. To keep it, open the account menu (your address at the top right), press Export testnet key, and import the copied key into Rabby (Add wallet, then Import private key). Anyone who has the key controls the account.

2. Get test funds and deposit

Skip this step if you used Try it now.
Your money is held by the settlement contract on chain, never by the exchange, so you trade with what you deposit there.
  1. Get test funds
    Open Funds from the account menu (your address at the top right) and press Get test funds. On an event's page the order slip's button offers the same, as GET TEST FUNDS. Sign the faucet's message, which is free and sends nothing. The faucet sends 1,000 test USDC, plus a little test ETH for transaction fees, to your wallet. It can take a minute or two to arrive. Each address gets one grant a day.
  2. Deposit
    Under Funds, Deposit, the grant is already entered as the amount. Press Deposit $1,000.00 and enable trading. Rabby asks three times: a signature that lets the contract take the USDC, the deposit transaction, and a transaction that registers a trading key this browser made. With that key, placing an order needs no wallet prompt. The key can never withdraw.
  3. Wait a few seconds
    The exchange credits a deposit once its block is a few seconds old. The order button counts this down, READY IN ~6s. If it reads STILL WAITING, the chain is slow. Nothing needs doing, and it updates by itself.
The smallest deposit is 10 USDC. Funding has the details.

3. Make a trade

  1. Pick a market
    Markets lists the questions with options listed on them. Each card shows the outcome's chance and two buttons:
    • UP buys one call at the current chance, a bet that the chance rises.
    • DOWN buys one put at the current chance, a bet that it falls.
    Each button shows what one contract costs now and the most it can pay (for example up to $55). Under the buttons are the strike and when the option ends. A price marked est. is the exchange's estimate because nobody is offering that option yet.
  2. Read the order slip
    Pressing UP or DOWN opens the event and fills the order slip on the right. Nothing is sent yet. The slip shows the order (SIDE, AMOUNT, TYPE, STRIKE, EXPIRY), the most it can make and lose, and the fee. One sentence under the figures says the same in words. To change the order, click a box: SIDE flips buy and sell, TYPE flips call and put, and EXECUTION switches between market and limit.
  3. Place it
    Press PLACE ORDER. A market order fills at once against the book, and a notice in the bottom-right corner confirms each fill. A limit order rests on the book until someone meets your price. If the button is greyed out, a red line under the slip says why, for example not enough free cash.
For any other strike or expiry, open the market's chain and press a price, or drag on its chart. Orders explains market and limit orders, and Prices and fees explains ticks and fees.

4. See your positions

  • Your positions, beside the outcome list on an event's page, shows what you hold on that event.
  • The Value figure in the top bar opens your portfolio across every market, with three tabs: HOLDINGS (what you hold), OPEN ORDERS (each with a CANCEL button) and HISTORY (every fill, settlement, deposit and withdrawal).
  • On a phone, use the Portfolio tab.
To get out before expiry, press FLATTEN on a position. It loads the closing order into the slip, and you still press PLACE ORDER. You can also hold the option to expiry. It then settles by itself, and an option that ends in the money pays its value into your free cash.

5. Withdraw

  1. Ask for it
    Open Funds from the account menu, then Withdraw. Enter an amount up to Available to withdraw (your free cash) and press Withdraw. Sign the request in your wallet. Only the wallet itself can withdraw. The trading key cannot. The exchange takes the amount from your free cash at once.
  2. Watch it arrive
    Your withdrawals shows each one move from REQUESTED (debited) to EXECUTED (the settlement contract has paid it out, in order with the trades before it) to COLLECTED (sent to your wallet), usually within a minute or two. The exchange sends it to your wallet for you. If Ready to pay to your wallet shows an amount that does not arrive, press COLLECT beside it: one transaction, which can only pay your own address.
A withdrawal over $5,000, made soon after a deposit, can wait a few minutes until the deposit's block is safe on the chain.
If the exchange stops answering, you can still get your money out through the contract alone. Funds, then More, then Exit hatch does this, and Custody explains how it works.

Next

  • The testnet: the chain, the faucet's limits and the account classes.
  • Security: what an order locks, and why a short never gets a margin call.
  • API quickstart: the same steps from a program.