Platform Notes
Choose the API by the question
Gamma, CLOB, Data, Relayer, and WebSocket surfaces answer different questions. Route discovery, execution, account history, wallet transactions, and live updates to the service that…
Category: Platform Notes
Product mechanics and changes across the Polymarket ecosystem.
Platform Notes
The signed request includes the exact route
CLOB authentication signs a fresh timestamp, HTTP method, route path, and exact request body. A valid API key cannot rescue a request that was…
Platform Notes
A delayed order is a real state, not an error
An accepted order can be live, matched, delayed, or unmatched. Treat delayed as pending matching work and keep order status separate from the trade's…
Platform Notes
A WebSocket reconnect is a state reset, not a resume
A real-time user stream reports order and trade changes, but it does not replay everything missed during a disconnect. Refresh authoritative account state before…
Platform Notes
A matching-engine restart changes the execution checklist
During a matching-engine restart, order actions can be rejected and the engine can return in post-only mode. Pause safely, honor server delays, and inspect…
Platform Notes
A session key is a permission boundary, not a second wallet
Session keys can let an integration sign scoped trading requests without turning automation into a second wallet. Treat scope, expiry, and owner reconciliation as…
Platform Notes
An order heartbeat is a safety stop
A CLOB heartbeat can cancel resting orders when a trading process stops responding. Treat the timeout as a risk control with its own monitoring…
Platform Notes
A trading upgrade changes the checklist before it changes the opportunity
Contract, collateral, and API changes deserve a fresh end-to-end review.
Platform Notes
The most important word in a market may be in the rules
A readable headline needs a precise event definition underneath it.
Platform Notes
An AI market assistant needs a source trail
A confident answer becomes useful when you can inspect the documents and dates behind it.