Watch Polymarket prices and order books from the chat

Polymarket has not one API but several, and the agent calls each for its own part: Gamma for events, markets, search and tags, CLOB for the order book, the spread and the quote history, Data API for positions, activity and leaderboards on the saved address. That is how the picture comes together: what the event is, at what price it trades, how deep the market is and how you are positioned in it.

A prediction market price is an estimate of probability, and the agent reads it together with the order book rather than on its own. In a thin market a single trade drags the last price far from anything you could actually enter at, so alongside the quote the agent shows the spread and the depth and separates a real market move from one drawn by a single order. Quote history is taken at the interval where the event is visible rather than smoothed away.

The agent cannot trade, by the way the connector is built: placing and cancelling orders requires a private key, which it neither stores nor accepts. All it does is read public data and break down your positions: which markets you are in, at what price you entered, what the portfolio is worth now. A recurring digest of markets about to close and of overnight price moves can be put on a schedule — that too is reading.

The connection is a single field with a wallet address: Polymarket neither issues nor requires an API key or a private key for reading, so there is nothing to revoke either — removing the address is enough. Positions are read against that address and matched with current market quotes, so the portfolio is valued as of the question, not as of the entry. Nothing behind a login is available to the agent at all: everything it sees is equally visible to anyone else. The connector keeps the request rate low, around one per second with a small allowance for bursts, and spreads calls across the three APIs so none of them hits its own limit.