Get a user's profile stats

The profile card for one wallet in a single call.

?user= is required. Returns { data: { trades, biggest_win, views, join_date, all_time_pnl } }, or { data: null } when the wallet is not a known user.

data: null and a row of zeros mean different things. null is “no such user”; zeros are “this user exists but has never traded, never won and has no profile views”.

trades counts DISTINCT MARKETS traded, not individual trades. It is exact, not estimated.

biggest_win is the best single resolved position win in USDC, market and combo arms unified, and 0 when the wallet has no win over $1.

join_date is epoch seconds, or null when unknown.

all_time_pnl is the newest persisted cumulative /v2/user-pnl point at its actual observation timestamp. It is null when the user exists but no observation has been published yet. For the composition card: trading realized is realized_market_pnl + realized_combo_pnl; LP realized is realized_lp_pnl; rebates, yield, rewards, referral, and fees paid map to their same-named fields (fees_paid is refunds minus charges). volume, volume_usdc, and trade_count are cumulative maker-attributed canonical fill metrics.

Not paginated: one row by construction, so data is the bare object with no pagination; the /v2/value shape.

GET /v2/user-stats

Get a user's profile stats

cURL

curl --request GET \
  --url https://data-api.polymarket.com/v2/user-stats \
  --header 'Authorization: Bearer <token>'

200

{
  "data": {
    "biggest_win": 123,
    "proxy_wallet": "<string>",
    "trades": 1,
    "views": 1,
    "all_time_pnl": {
      "realized_combo_pnl": 123,
      "realized_lp_pnl": 123,
      "realized_market_pnl": 123,
      "realized_pnl": 123,
      "source_block": 123,
      "timestamp": 123,
      "trade_count": 1,
      "volume": 123,
      "volume_usdc": 123,
      "cashflow_net": 123,
      "deposits": 123,
      "economic_pnl": 123,
      "fees": 123,
      "fees_paid": 123,
      "fees_refunded": 123,
      "maker_rebate": 123,
      "position_pnl": 123,
      "referral_income": 123,
      "reward_income": 123,
      "settled_pnl": 123,
      "sponsored_income": 123,
      "taker_rebate": 123,
      "trade_pnl": 123,
      "unrealized_pnl": 123,
      "wallet_income": 123,
      "withdrawals": 123,
      "yield_income": 123
    },
    "join_date": 123
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

user · string | null

The wallet whose profile stats to return. Required; 0x followed by 40 hexadecimal characters.

Response

200

application/json

The wallet's profile stats, or null when it is not a known user

{ "data": T }; the envelope for endpoints that don't paginate.

There is no pagination key: an aggregate or bounded list has no next page. Paginated feeds return a *Page shape ({ data, pagination }) instead.

data · null | object · required

The profile card for one wallet, plus its newest persisted all-time PnL observation.

join_date is null when unknown, which is a real state rather than an error; a meaningful share of accounts have no recorded creation time. biggest_win is 0 when the wallet has no win over $1. all_time_pnl is null when the user is known but has no observation yet; a missing user is represented by the outer response data: null instead.

Show child attributes