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

# Large Positions

> Current large open positions across all tracked accounts, notional-sorted — a live whale-position feed. Filter by `min_notional` and `instrument`.

A live feed of the biggest open perps positions across every tracked account, sorted by notional. Set the floor with `?min_notional=` (USD, default 10,000), narrow to one market with `?instrument=`, and cap the count with `?limit=`.

Each row is that account's current position for an instrument — address, side, size, notional, and unrealized PnL — drawn from its latest snapshot (`as_of`). Use it to watch where the size is concentrated right now.


## OpenAPI

````yaml GET /v3/perps/positions/large
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/positions/large:
    get:
      tags:
        - Perps
      summary: Large positions
      description: >-
        Current large open positions across all tracked accounts,
        notional-sorted — a live whale-position feed. Filter by `min_notional`
        and `instrument`.
      operationId: perps_large_positions
      parameters:
        - name: min_notional
          in: query
          required: false
          description: Minimum position notional in USD (default 10000)
          schema:
            type: number
        - name: instrument
          in: query
          required: false
          description: Restrict to one instrument
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Max rows (default 100)
          schema:
            type: integer
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                data:
                  - address: '0x4f78dcb560f85bb028d6b75467c4bcb6412f8731'
                    as_of: 1783602532386
                    instrument_id: 1
                    notional: '1004045.393600'
                    side: short
                    size: '-133.91200'
                    symbol: SP500-USD
                    unrealized_pnl: '-2324.0915037805232000'
                  - address: '0x2e4f2c311efbb8ab3adb9f7b7667af92e8a2af96'
                    as_of: 1783602083934
                    instrument_id: 1
                    notional: '1003911.481600'
                    side: long
                    size: '133.91200'
                    symbol: SP500-USD
                    unrealized_pnl: '2324.0915037805232000'
                  - address: '0xece7144d08695fee681496a5de501a0faa6c05ec'
                    as_of: 1783602083934
                    instrument_id: 1
                    notional: '1002539.192360'
                    side: short
                    size: '-133.72895'
                    symbol: SP500-USD
                    unrealized_pnl: '-7024.165515422452030000000004'
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````