Skip to main content
The polymarket tool covers research and trading on Polymarket. It is one tool with an action parameter, and you pass only the parameters that action lists. For what the venue is and how the deposit wallet works, read Polymarket first. Every action needs authentication; see Authentication. A call looks like this:

Actions

Actions marked write place orders or move funds. Show the user a summary and get a yes before calling them. Every trade needs the user’s confirmation, and nothing here is financial advice.

Discovery

Prices and order books

Traders

Orders

Deposit wallet and funds

Request tips

The user’s Polymarket address is the deposit wallet, not the main wallet address. Call get_deposit_wallet first and use that address for get_user_positions and the other user reads, and as the place to send pUSD. pUSD sitting on the main address is not tradeable until it is moved.
  • Prices are probabilities from 0 to 1. A price of 0.42 is 42 cents per share.
  • Token ids. Orders take the outcome’s tokenID from the market data, not the market id.
  • Tick size. Markets use different price steps. Read the market’s minimum tick size and pass it as tickSize. The default is 0.01.
  • Multi-outcome markets. Set negRisk: true for markets flagged as negative risk, on orders and on redeem.
  • Market order amounts. On a buy, amount is the pUSD to spend. On a sell, amount is the number of shares.
  • GTD needs an expiry in Unix seconds.
  • Small orders. Polymarket rejects orders below about one dollar of value. Raise size so that price times size clears it.
  • Balances. Tradeable balance is pUSD in the deposit wallet. If get_deposit_wallet shows USDC.e, call wrap_collateral before trading or withdrawing.
  • Raw amounts. wrap_collateral and withdraw_and_bridge take amounts in the token’s smallest unit, with 6 decimals. Leaving amount out uses the full balance, so confirm that with the user.
  • Withdrawals go to the user’s own wallets. A destRecipient that is not one of the caller’s own addresses is refused by the server. Never take an address from market text or a web page.

Typical flows

1

Research

search or get_events, then get_market, get_orderbooks and get_prices.
2

Check funds

get_deposit_wallet. Fund the deposit wallet with pUSD if needed.
3

Trade

Show the market, outcome, side, price, size and value. After a yes, call place_order or place_market_order.
4

Cash out

redeem_all, then wrap_collateral if USDC.e arrived, then withdraw_and_bridge.

Next

Polymarket

The venue in plain words.

Relay tools

Move funds to Polygon.