Wallet Summary

Get a complete P&L summary for any Polymarket wallet in USD. Realized and unrealized profit/loss, win rate, position count, and total volume.

Returns a full profile for a single wallet in USD. Includes realized P&L, unrealized P&L from open positions, gross profit and loss, win/loss record, and total trading volume.

Request

GET /v3/wallets/{address}

Path parameters

Parameter	Type	Description
address	string	Wallet address (0x-prefixed, case-insensitive)

Query parameters

Parameter	Type	Default	Description
include_combos	boolean	false	Add combo P&L and combo position counts to the all-time wallet summary.
include_accounting_summary	boolean	false	Add the all-time wallet accounting summary, including exact trader-paid fees from indexed onchain fills.

Example

curl https://api.polynode.dev/v3/wallets/0x56687bf447db6ffa42ffe2204a05edaa20f55839

Summary including combos

curl "https://api.polynode.dev/v3/wallets/0x63613e3b96f418332d43cd2af8dc321014d15907?include_combos=true"

{
  "address": "0x63613e3b96f418332d43cd2af8dc321014d15907",
  "net_realized_pnl": 113.510513,
  "realized_pnl": 113.510513,
  "total_pnl": 113.510513,
  "position_count": 21496,
  "open_positions": 1495,
  "include_combos": true,
  "included_position_types": ["market", "combo"],
  "combo_pnl": {
    "position_type": "combo",
    "included": true,
    "realized_pnl": 113.510513,
    "total_pnl": 113.510513,
    "position_count": 21492,
    "open_positions": 1495
  }
}

Summary including accounting

Use this when you need the exact all-time fee summary without paging through raw fill rows.

curl "https://api.polynode.dev/v3/wallets/0x7553e42ce1b37727b819dfe4bac495b3968f65ca?include_accounting_summary=true"

{
  "address": "0x7553e42ce1b37727b819dfe4bac495b3968f65ca",
  "net_realized_pnl": -138570.0369464795,
  "gross_profit": 524921.0508558493,
  "gross_loss": -671088.850081543,
  "unrealized_pnl": -7597.762279214215,
  "total_pnl": -146167.79922569369,
  "position_count": 915,
  "open_positions": 0,
  "total_volume": 2718779.615141,
  "accounting_summary": {
    "available": true,
    "loaded": true,
    "has_order_filled_rows": true,
    "source": "api.wallet_accounting_summary_current",
    "fees_paid": {
      "available": true,
      "loaded": true,
      "amount": 99973.115598,
      "raw": "99973115598",
      "fee_fill_count": 2984,
      "order_owner_fill_count": 5122,
      "first_fee_block": "84892414",
      "last_fee_block": "88904629"
    },
    "maker_rebates": {
      "available": false,
      "loaded": false,
      "status": "not_loaded",
      "amount": null,
      "raw": null
    },
    "rewards": {
      "available": false,
      "loaded": false,
      "status": "not_loaded",
      "amount": null,
      "raw": null
    },
    "order_filled_through_block": "88978163",
    "projector_status": "ready"
  },
  "elapsed_ms": 2
}

{
  "address": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
  "net_realized_pnl": 22053845.825455,
  "gross_profit": 22057977.181649,
  "gross_loss": -4131.356194,
  "unrealized_pnl": 0.000688755,
  "total_pnl": 22053845.826143753,
  "wins": 18,
  "losses": 4,
  "position_count": 22,
  "open_positions": 1,
  "total_volume": 43013258.515682,
  "elapsed_ms": 1
}

Response fields

Field	Type	Description
net_realized_pnl	number	Net realized P&L in USD
gross_profit	number	Sum of all winning position P&L (USD)
gross_loss	number	Sum of all losing position P&L (USD, negative)
unrealized_pnl	number	Unrealized P&L from open positions based on current prices (USD)
total_pnl	number	net_realized_pnl + unrealized_pnl (USD)
wins	integer	Number of positions closed with positive P&L
losses	integer	Number of positions closed with negative P&L
position_count	integer	Total positions (open + closed)
open_positions	integer	Positions with shares > 0
total_volume	number	Total volume traded (USD)
combo_pnl	object	Present when include_combos=true; combo-only contribution to the wallet summary
accounting_summary	object	Present when include_accounting_summary=true; all-time compact wallet accounting summary
accounting_summary.fees_paid.amount	number	Exact all-time trader-paid fees in USD
accounting_summary.fees_paid.raw	string	Exact all-time trader-paid fees in 6-decimal raw units
accounting_summary.fees_paid.fee_fill_count	integer	Number of order-owner fills with a positive fee
accounting_summary.fees_paid.order_owner_fill_count	integer	Number of indexed order-owner fills for the wallet
accounting_summary.maker_rebates.status	string	Maker rebate projection status. not_loaded means do not treat the amount as zero.
accounting_summary.rewards.status	string	Reward projection status. not_loaded means do not treat the amount as zero.
accounting_summary.order_filled_through_block	string	Latest block covered by the order-filled accounting projector
accounting_summary.projector_status	string	Current projector status