Strategy · lesson 09 of 09
Polymarket wallet tracker: how to look up any trader’s positions and PnL
Every Polymarket.com account is a public wallet, so anyone can see its positions, trades and profit, on its profile page or through Polymarket’s free Data API. How to look up a trader, which endpoints to use since the API moved to v2, and why Polymarket US accounts can’t be tracked the same way.
In one minute
- Profile pages at polymarket.com/@username or /profile/0x… show a trader’s positions, activity, volume and profit and loss.
- The Data API at data-api.polymarket.com/v2 returns the same data as JSON, with no key.
- The old v1 endpoints were retired on 2 November 2026 and now return HTTP 410.
- Polymarket US accounts are private: its portfolio API works only for your own account, with a key.
Why Polymarket wallets are public
On Polymarket.com, “shares are represented as ERC-1155 tokens on Polygon” and “all trades are settled through smart contracts on the blockchain” (Polymarket 101). Every position therefore sits in a public wallet. A profile shows an auto-generated pseudonym unless the trader chooses a display name, but the wallet’s history stays visible: even after an account is deleted, Polymarket says, “your past transaction history will remain visible on-chain” (Polymarket help centre).
Looking a trader up on the website
Open polymarket.com/@username or polymarket.com/profile/ followed by the wallet address. The profile shows when the account joined, positions value, biggest win, markets traded, total volume and total profit and loss, with a chart over a day, week, month, year or all time. The Positions tab splits open and closed positions, each with side, average price, current price, shares, value and profit. To find traders worth watching, start from the Polymarket leaderboard.
Tracking wallets with the Data API
“No API key or authentication is required” for the Data API, whose base is https://data-api.polymarket.com/v2 (Data API overview). The endpoints a tracker needs (wallet activity):
Endpoint | Returns |
|---|---|
GET /v2/positions?user=0x… | Positions; status OPEN (default), CLOSED, REDEEMABLE and others |
GET /v2/activity?user=0x… | Trades, redemptions and other activity |
GET /v2/trades?user=0x… | Trade history, up to 1,000 rows a page |
GET /v2/value?user=0x… | Current portfolio value |
GET /v2/user-pnl?user=0x… | Cumulative profit and loss over time |
GET /v2/user-stats?user=0x… | Profile stats: trades, biggest win, join date |
GET /v2/holders?condition=… | The largest holders of each outcome in a market |
GET /v2/leaderboard | Top traders by profit or volume, by day, week, month or all time |
- Pagination is by cursor only: “there is no offset query parameter.”
- Anything built on the old routes broke on 2 November 2026: “Data API v1 retires on November 2, 2026” (migration guide). /closed-positions is now /v2/positions with status=CLOSED.
- The profit series is cumulative; Polymarket warns, “Do not sum them as period returns.”
- Display names and X usernames come from the Gamma API’s public profile endpoint. The leaderboard is documented here.
- Limits are per IP address, about 200 requests per 10 seconds for /v2/positions and /v2/activity. Over the limit, requests are slowed rather than refused at first, then answered with HTTP 429 (rate limits).
What a tracker can’t tell you
- Who is behind a wallet. One person can run many wallets, and a large position may be a hedge.
- Whether a trader is still right. Past profit on a leaderboard is not a forecast, and copying a trade later means a worse price.
- Anything about Polymarket US. Its portfolio endpoints “require API key authentication” and return only your own account (Polymarket US docs).
The rest of Polymarket’s APIs are covered in the Polymarket API; for price history, see Polymarket historical data.
See it live on Polymarket
Largest on-chain prediction market by volume
Common questions
Can you see other people’s positions on Polymarket?+
Yes, on Polymarket.com. Positions are tokens in public wallets, and each profile shows open and closed positions, trades and profit. Polymarket US accounts are not public.
How do I track a Polymarket wallet?+
Open polymarket.com/profile/ followed by the wallet address, or call data-api.polymarket.com/v2/positions?user= with the address. The Data API needs no key and also has activity, trades, value and profit endpoints.
Why did my Polymarket tracker stop working?+
Polymarket retired Data API v1 on 2 November 2026, and the old routes now return HTTP 410. Move to the /v2 endpoints, which use cursor pagination instead of offsets.
Is Polymarket anonymous?+
Pseudonymous. Profiles show an auto-generated name unless you choose one, but your wallet’s trades are public on the blockchain and stay visible even if you delete your account.