/v4/data/prediction/wallets/{address}/history

100 credits per API call

Closed and resolved positions for a wallet — one row per settled position (winning or losing), with the realised PnL, lifetime cost basis, settlement price, and the parent market's question and outcome metadata. Useful for backtest-style P&L drill-downs and tax exports.

Platform support

• Polymarket only. Kalshi wallets return 400.

Filtering, sorting and pagination

• market scopes the response to a comma-separated list of condition ids (0x + 64 hex), up to 50 entries.
• eventId scopes the response to a comma-separated list of Polymarket numeric event ids, up to 50 entries. Mutually exclusive with market — passing both returns 400.
• title filters by a substring of the market question.
• sortBy accepts REALIZEDPNL, TITLE, PRICE, AVGPRICE, TIMESTAMP. Defaults to REALIZEDPNL. Combine with sortDirection (ASC / DESC, defaults to DESC).
• Pagination is offset-based — limit (1..50, default 10) and offset (0..100000, default 0).

Other notes

• address is normalised to lowercase before being echoed in the response (every row's proxyWallet).
• timestamp is unix-seconds (not milliseconds) — the settlement time of the position.
• curPrice is the resolution price (0 or 1 for binary markets); avgPrice is the volume-weighted entry price.