How to track Polymarket wallets: free P&L, skill score, and copyability check

Track a wallet with Polymarket's public Data API

To pull wallet data yourself, Polymarket publishes a read-only Data API at data-api.polymarket.com. It is public: no API key, no login. The examples use the v2 routes (Polymarket's migration guide retires v1 on October 24, 2026) and a wallet from our public board; swap in any 0x address. jq is optional and only trims the output. Responses below were captured on October 19, 2026 and are trimmed.

1. Current positions: GET /v2/positions

ADDRESS=0x0df2c9deeb278ade65454023eca05cdcaa025d51

curl -s "https://data-api.polymarket.com/v2/positions?user=$ADDRESS&limit=5"   | jq '.data[] | {title, outcome, status, current_size, avg_price, current_value, total_pnl}'

{
  "title": "Spread: Real Madrid CF (-1.5)",
  "outcome": "Real Madrid CF",
  "status": "REDEEMABLE",
  "current_size": 12000.0,
  "avg_price": 0.51,
  "current_value": 0.0,
  "total_pnl": -6120.0
}

current_size is in shares, avg_price is the weighted-average entry price, and dollar fields are in USDC. status defaults to OPEN, which also includes resolved positions the wallet has not redeemed yet (they come back as REDEEMABLE, like the losing position above). Pass status=CLOSED for exited positions. Pages are cursor-based: send pagination.next_cursor back as cursor with the same user. Reference: List positions.

2. Recent trades: GET /v2/activity

curl -s "https://data-api.polymarket.com/v2/activity?user=$ADDRESS&type=TRADE&limit=3"   | jq '.data[] | {timestamp, side, title, outcome, size, usdc_size, price}'

{ "timestamp": 1792269155, "side": "BUY", "title": "Valencia CF vs. Athletic Club: O/U 0.5",
  "outcome": "Over", "size": 2408.14, "usdc_size": 1204.07, "price": 0.5 }
{ "timestamp": 1792269153, "side": "BUY", "title": "Valencia CF vs. Athletic Club: O/U 0.5",
  "outcome": "Over", "size": 2652.12, "usdc_size": 1326.06, "price": 0.5 }

timestamp is epoch seconds, size is shares, and usdc_size is the cash value. Drop type=TRADE to also see redeems, merges, splits and rewards. Note the two fills two seconds apart in the same market: large traders split one decision into many fills, so a raw feed makes them look far busier than they are. For fills only, use GET /v2/trades?user=; it serves each fill on its taker side by default, so add taker_only=false to include the wallet's maker fills. Reference: List account activity.

3. Realized P&L and return on money risked

// pnl.mjs: node pnl.mjs 0x...
const API = "https://data-api.polymarket.com/v2/positions";

// Walk every page of one position status for a wallet.
async function positions(user, status) {
  const rows = [];
  let cursor = null;
  do {
    const q = new URLSearchParams({ user, status, limit: "500" });
    if (cursor) q.set("cursor", cursor);
    const body = await (await fetch(`${API}?${q}`)).json();
    rows.push(...body.data);
    cursor = body.pagination.next_cursor;
  } while (cursor);
  return rows;
}

const user = process.argv[2];
// CLOSED = exited positions; REDEEMABLE = resolved, still held (winners and losers).
const settled = [
  ...(await positions(user, "CLOSED")),
  ...(await positions(user, "REDEEMABLE")),
];
const pnl = settled.reduce((s, p) => s + p.total_pnl, 0);
const risked = settled.reduce((s, p) => s + p.total_size * p.avg_price, 0);
console.log({
  positions: settled.length,
  pnl: Math.round(pnl),
  risked: Math.round(risked),
  roiOnRisked: `${((pnl / risked) * 100).toFixed(1)}%`,
});

This needs Node 18 or later. It sums total_pnl over CLOSED positions and REDEEMABLE ones (resolved but still held). Summing only closed positions misses losers a wallet never sells or redeems, which flatters the record. Money risked per position is total_size × avg_price: lifetime shares bought times the average entry price.

What the API can't tell you: skill, luck, and copyability

The script gives you a P&L and a return. Neither answers the two questions that matter before you follow a wallet: is the record skill or luck, and could you actually copy it? Shark Radar checks three things on top of the raw data.

• ROI on money risked, not dollars. Our skill score is total P&L divided by total stake on resolved positions, so a big bankroll cannot buy the top of the board. Win rate alone misleads: a share pays $1, so the break-even win rate equals the all-in price paid. A wallet buying at 90¢ has to be right more than 90% of the time just to break even.
• A minimum sample. A wallet needs at least 25 resolved positions to appear on our board, and we flag any record whose largest single win is more than 40% of its gross gains. One lucky market is not a track record.
• Style checks. Some profit is real but cannot be copied by a follower. We mark these styles as not copyable and keep them off the board:
  • Market maker: Quotes both sides and earns the spread — copying one leg is not the strategy it runs.
  • Arbitrage bot: Arbitrages a market's own legs against each other — there is no directional bet to copy.
  • Latency bot: Reacts in the last hour before a market resolves — a follower is the latency it beats.
  • Scalper: Makes its money on intraday exits — copy-sim holds to resolution, a different strategy.
  Wallets that mostly buy near-certain favorites stay on the board, labeled Favourite buyer (high win rate, thin margins), so a high hit rate is not mistaken for forecasting skill.

Run these checks on any address with the Polymarket wallet checker, see which wallets pass today on the best Polymarket traders board, or read the full definitions in our methodology.

API details from Polymarket's documentation: Data API v2 overview, List positions, List account activity, List trades and the Wallet Activity guide.