> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Portfolio

> Live perps positions and equity for a wallet, enriched per position with symbol, side, mark price and notional.

## Fields

| Field        | Meaning                                                                     |
| ------------ | --------------------------------------------------------------------------- |
| `symbol`     | Instrument symbol, so no lookup table is needed                             |
| `side`       | `long` / `short`, made explicit (raw `size` stays signed: negative = short) |
| `mark_price` | Live mark at response time                                                  |
| `notional`   | Absolute position value at mark (derived, 2dp)                              |

`equity`, `size`, `entry_price`, and `unrealized_pnl` keep their exact string precision.

## Filters

Narrow the position list server-side (Polymarket returns the full list only): `side`, `instrument`, `min_notional`, `min_roe`, and `sort` (`notional` or `pnl`). Unknown values return a `400`. To pull many wallets at once, use the [batch portfolios](/perps/wallets/batch-portfolios) endpoint.

Portfolio data refreshes every few seconds per wallet. Works with either address form — proxy or signer ([details](/perps/wallet-mapping)).


## OpenAPI

````yaml GET /v3/perps/wallets/{address}/portfolio
openapi: 3.1.0
info:
  title: PolyNode API
  description: >-
    Real-time Polymarket data API with decoded mempool settlements, OHLCV
    candles, and full Polygon JSON-RPC proxy.
  contact:
    name: PolyNode
    url: https://polynode.dev
  license:
    name: ''
  version: 2.0.0
servers:
  - url: https://api.polynode.dev
    description: Production
security:
  - api_key: []
paths:
  /v3/perps/wallets/{address}/portfolio:
    get:
      tags:
        - Perps
      summary: Wallet portfolio
      description: >-
        Live perps positions and equity for a wallet, enriched per position with
        symbol, side, mark price and notional.
      operationId: perps_wallet_portfolio
      parameters:
        - name: address
          in: path
          required: true
          description: >-
            Polymarket proxy wallet **or** signer EOA (`0x...`). Resolution is
            automatic.
          schema:
            type: string
        - name: side
          in: query
          required: false
          description: 'Filter positions: long | short'
          schema:
            type: string
        - name: instrument
          in: query
          required: false
          description: Restrict to one instrument
          schema:
            type: string
        - name: min_notional
          in: query
          required: false
          description: Minimum position notional, USD
          schema:
            type: number
        - name: min_roe
          in: query
          required: false
          description: Minimum return on equity
          schema:
            type: number
        - name: sort
          in: query
          required: false
          description: Sort positions by notional | pnl
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              example: {}
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````