Data API
Polymarket's on-chain activity API that exposes wallet positions, trade history, and large holder data used for whale copy-trading.
Definition
The Polymarket Data API provides access to on-chain position and trade data aggregated from Polygon. It exposes current conditional token holdings by wallet address, recent trade activity, and profit/loss history for any public wallet. This API is the primary data source for identifying large traders (whales) and monitoring their activity.
In practice
The polycopy bot's lib/watcher.js polls the Data API to detect when a tracked whale wallet opens or closes a significant position. When a new trade appears above the configured size threshold, the copier module mirrors the trade on the CLOB with a scaled-down position. The Data API does not require authentication for reading public wallet data, making it straightforward to monitor any number of whale addresses without API keys.