Wallet Identity (Polymarket)

Consolidated trader profile for any Polymarket wallet - display name, proxy and base address mapping, lifetime volume, lifetime and windowed PnL (24h, 7d, 30d), open-position value, trade count, largest win, and account age. One call turns a bare address into a full trader profile, including the proxy wallet needed for positions and activity lookups.

GET/v2/wallet/{addr}/identity

Plans All plansPlan rate limits apply

Parameters

addrstring (path)required

Wallet address - must match ^0x[a-fA-F0-9]{40}$. Lowercased before lookup.

Response

walletstring

Wallet address (lowercased).

has_polymarket_databoolean

True if the wallet has a real Polymarket footprint (name, trades, volume, positions, or a recorded win). Lets you distinguish an active trader from an address that has never traded in a single field.

proxy_walletstring

Polymarket proxy wallet address. Use this for /v2/wallet/{addr}/positions and /v2/polymarket/activity - the base/EOA address returns no results.

base_addressstring

Funding (EOA) address behind the proxy.

primary_addressstring

Primary EVM address linked to the profile.

profile_slugstring

Profile URL slug - username for named accounts, address for anonymous ones.

is_anonymousboolean

True when the wallet has no public Polymarket username.

display_namestring

Public Polymarket display name. Null for anonymous wallets.

pseudonymstring

Public identity handle (same value as display_name).

lifetime_volume_usdnumber

Lifetime trading volume in USDC. Null when unavailable for the wallet.

lifetime_pnl_usdnumber

Cumulative lifetime PnL in USDC, net of trading fees - the same figure shown on the trader's Polymarket P&L chart. Null for low-activity or anonymous wallets.

pnl_1d_usdnumber

Net PnL over the last 24 hours, in USDC.

pnl_1w_usdnumber

Net PnL over the last 7 days, in USDC.

pnl_1m_usdnumber

Net PnL over the last 30 days, in USDC.

positions_value_usdnumber

Current USDC value of all open positions.

position_countinteger

Number of open positions.

trades_countinteger

Total number of trades.

largest_win_usdnumber

Largest single-position win in USDC.

profile_viewsinteger

Profile page view count.

created_atstring

Account creation timestamp.

_metaobject

Source and cache state.

Show 4 fields

sourcestring

Data source identifier.

cachestring

Whether the response was served from cache (hit), freshly resolved (miss), or the last-known cached value (stale).

cached_atinteger

Unix timestamp the cached entry was written.

ttl_secondsinteger

Cache lifetime in seconds.