Migrate to Polymarket V2

Migration Checklist

Follow these steps to ensure your integration is ready for V2.

Code Example: Order Placement

Updated syntax for placing orders on CTF Exchange V2.

// Place a buy order on CTF Exchange V2
import { CTFExchangeV2 } from "@polymarket/ctf-v2";

const exchange = new CTFExchangeV2({
  providerUrl: "https://polygon-rpc.com",
  privateKey: process.env.PRIVATE_KEY,
  apiKey: process.env.POLYMARKET_API_KEY,
});

// Approve pUSD before placing orders (one-time)
await exchange.approveCollateral({
  amount: "1000000000", // 1000 pUSD (6 decimals)
});

const order = await exchange.placeOrder({
  tokenID: "123456789012345678901234567890",
  side: "BUY",
  price: 0.65,
  size: 100,
  feeRateBps: 100, // Fees calculated at match time
});

console.log("Order placed:", order.orderId);

# Place a buy order on CTF Exchange V2
from polymarket_v2 import CTFExchangeV2

exchange = CTFExchangeV2(
    provider_url="https://polygon-rpc.com",
    private_key=os.getenv("PRIVATE_KEY"),
    api_key=os.getenv("POLYMARKET_API_KEY"),
)

# Approve pUSD before placing orders (one-time)
exchange.approve_collateral(
    amount="1000000000"  # 1000 pUSD (6 decimals)
)

order = exchange.place_order(
    token_id="123456789012345678901234567890",
    side="BUY",
    price=0.65,
    size=100,
    fee_rate_bps=100,  # Fees calculated at match time
)

print("Order placed:", order.order_id)

Error Code Changes

New and updated error codes for V2.