Skip to main content
GET
/
v1
/
trader
/
{wallet}
Trader profile
curl --request GET \
  --url https://api.polynode.dev/v1/trader/{wallet} \
  --header 'x-api-key: <api-key>'
{
  "wallet": "0xc2e7800b5af46e6093872b177b7a5e7f0563be51",
  "eoaWallet": "0xb49e5499562a4bc3345c1a1f2db13a5360dfddac",
  "name": "beachboy4",
  "pseudonym": "Threadbare-Skunk",
  "profileSlug": "@beachboy4",
  "joinDate": "2025-11-30T17:26:07.997000Z",
  "trades": 149,
  "marketsTraded": 149,
  "largestWin": 3487512.609533,
  "views": 111735,
  "totalVolume": 199137316.6,
  "totalPnl": 4142102.07,
  "realizedPnl": 0,
  "unrealizedPnl": 0,
  "positionValue": 4418.03,
  "profileImage": null
}
Returns comprehensive stats for a trader: PnL, volume, trade count, largest win, current portfolio value, and account metadata. Data is sourced from Polymarket’s own profile page.
For V3 wallet-level accounting, including exact all-time trader-paid fees, use GET /v3/wallets/{address}?include_accounting_summary=true. The V3 accounting summary is sourced from PolyNode’s indexed onchain fill data and does not require paging raw fee rows.
totalPnl is the net portfolio PnL that matches the number shown on a Polymarket profile page. This factors in realized gains, cost basis still deployed in open positions, and unrealized gains/losses. If you want total realized gains from closed positions instead, use the onchain positions endpoint’s total_realized_pnl field. The response includes an eoaWallet field that resolves the underlying EOA (externally owned account) for Polymarket Safe proxy wallets. This is derived onchain via the Gnosis Safe getOwners() call. For older lightweight proxy wallets that don’t support this method, eoaWallet returns null.
​
wallet
string
required
Polymarket wallet address (e.g., 0xc2e7800b5af46e6093872b177b7a5e7f0563be51).
{
  "wallet": "0xc2e7800b5af46e6093872b177b7a5e7f0563be51",
  "eoaWallet": "0xb49e5499562a4bc3345c1a1f2db13a5360dfddac",
  "name": "beachboy4",
  "pseudonym": "Threadbare-Skunk",
  "profileSlug": "@beachboy4",
  "joinDate": "2025-11-30T17:26:07.997000Z",
  "trades": 149,
  "marketsTraded": 149,
  "largestWin": 3487512.609533,
  "views": 111735,
  "totalVolume": 199137316.6,
  "totalPnl": 4142102.07,
  "realizedPnl": 0,
  "unrealizedPnl": 0,
  "positionValue": 4418.03,
  "profileImage": null
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
wallet
string
required

Polymarket wallet address

Response

Trader profile

The response is of type object.