// Polymarket CLOB API knowledge base for order management, WebSocket events, and trading operations. Use when working with order lifecycle (place, fill, cancel), debugging WebSocket USER_TRADE/USER_ORDER events, understanding API field mappings, or implementing trading logic.
| name | polymarket-knowledge |
| description | Polymarket CLOB API knowledge base for order management, WebSocket events, and trading operations. Use when working with order lifecycle (place, fill, cancel), debugging WebSocket USER_TRADE/USER_ORDER events, understanding API field mappings, or implementing trading logic. |
Comprehensive reference for Polymarket CLOB API integration, focusing on order management and real-time event handling.
| Type | Behavior | Use Case |
|---|---|---|
| GTC | Good Till Cancelled | Maker orders, liquidity provision |
| GTD | Good Till Date | Time-limited orders |
| FOK | Fill Or Kill | Must fill completely or cancel |
| FAK | Fill And Kill | Fill what you can, cancel rest |
See references/order-state-machine.md for complete state diagram and transitions.
States: PENDING → OPEN → PARTIALLY_FILLED → FILLED/CANCELLED/EXPIRED
API Status Mapping:
live → OPENmatched (partial) → PARTIALLY_FILLEDmatched (full) → FILLEDdelayed → PENDINGcancelled → CANCELLEDexpired → EXPIREDSee references/websocket-events.md for field mappings and examples.
Key Endpoints:
wss://ws-subscriptions-clob.polymarket.com/ws/marketwss://ws-subscriptions-clob.polymarket.com/ws/user (authenticated)USER_ORDER Event Types: PLACEMENT, UPDATE, CANCELLATION USER_TRADE Statuses: MATCHED, MINED, CONFIRMED, RETRYING, FAILED
matched_amount not matched_size, size_matched not matched_size/ws/user, not /ws/market