This guide walks you through placing an order on Polymarket end-to-end.Documentation Index
Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
Use this file to discover all available pages before exploring further.
Set Up Your Client
Derive your API credentials and initialize the trading client. This example uses
a deposit wallet with signature type
3 (POLY_1271), which is the wallet path
for new API users:Existing EOA, Safe, and Proxy integrations can keep using their current
signature type and funder address. See Signature
Types for all wallet types.
Place an Order
Get a token ID from the Markets API, then create and submit your order:
Troubleshooting
L2 AUTH NOT AVAILABLE - Invalid Signature
L2 AUTH NOT AVAILABLE - Invalid Signature
Wrong private key, signature type, or funder address for the derived API credentials.
- Check that
signatureTypematches your account type (0,1,2, or3) - Ensure
funderis correct for your wallet type - Re-derive credentials with
createOrDeriveApiKey()if unsure
Order rejected - insufficient balance
Order rejected - insufficient balance
Your funder address doesn’t have enough tokens:
- BUY orders: need pUSD in your funder address
- SELL orders: need outcome tokens in your funder address
- Ensure you have more pUSD than what’s committed in open orders
Order rejected - insufficient allowance
Order rejected - insufficient allowance
You need to approve the Exchange contract to spend your tokens. Deposit wallet
approvals must be executed from the deposit wallet through a relayer
WALLET
batch. Existing Safe and Proxy users should use their current relayer approval
flow.What is my funder address
What is my funder address
Your funder address is the wallet where your funds are held:
- EOA (type 0): Your wallet address directly
- Deposit wallet (type 3): The deposit wallet deployed for the owner or session signer
- Proxy/Safe wallet (type 1 or 2): Existing Polymarket.com wallet address
Blocked by Cloudflare or Geoblock
Blocked by Cloudflare or Geoblock
You’re trying to place a trade from a restricted region. See Geographic Restrictions for details.
Next Steps
Create Orders
Order types, tick sizes, and error handling
Order Attribution
Attribute orders to your builder account for volume credit