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
}

Documentation Index

Fetch the complete documentation index at: https://polynode.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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. 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.