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

# Get Open Positions

> Returns all currently open positions for a wallet — every outcome token held with a non-zero balance, along with pricing, PnL, and market metadata.



## OpenAPI

````yaml openapi.json GET /v1/trader/{address}/positions/open
openapi: 3.1.0
info:
  title: Orbscan Open API
  description: >-
    REST endpoints for Polymarket trader activity, deposits & withdrawals, and
    per-transaction action details, sourced directly from on-chain data.
  version: 1.0.0
servers:
  - url: https://api.orbscan.com
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/trader/{address}/positions/open:
    get:
      summary: Get open positions
      description: >-
        Returns all currently open positions for a wallet — every outcome token
        the wallet holds with a non-zero balance, along with pricing, PnL, and
        market metadata.
      operationId: getOpenPositions
      parameters:
        - name: address
          in: path
          required: true
          description: The wallet address to query.
          schema:
            type: string
            example: '0x0484e64092ba4108c2786b61e6fc052d3bf41b1a'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: OK
                  status_code:
                    type: string
                    example: '1'
                  data:
                    type: object
                    properties:
                      items:
                        type: array
                        items:
                          $ref: '#/components/schemas/OpenPosition'
                      nextCursor:
                        type: string
                        nullable: true
              example:
                message: OK
                status_code: '1'
                data:
                  items:
                    - marketId: '3656310'
                      marketSlug: btc-updown-5m-1787031000
                      eventSlug: btc-updown-5m-1787031000
                      conditionId: >-
                        0xa31ec3151a6791a9e74d5f5f84b1f0c00fa077212f9b63fc5582fba6bfc87cce
                      marketTitle: Bitcoin Up or Down - August 18, 1:30AM-1:35AM ET
                      logo: >-
                        https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png
                      closed: false
                      tokenId: >-
                        100556202915779895602586020414430867023426296240912333256993650161520744311843
                      positionSide: Up
                      outcomeIndex: 0
                      balance: '45'
                      avgPrice: '0.175555'
                      currentPrice: '0.01'
                      avgExit: '0'
                      totalInvested: '7.899975'
                      totalBought: '45'
                      value: '0.45'
                      unrealizedPnl: '-7.449975'
                      realizedPnl: '0'
                      totalPnl: '-7.449975'
                      percentPnl: '-94.303779'
                      recentTradeTime: 1787031184
                  nextCursor: null
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    OpenPosition:
      type: object
      properties:
        marketId:
          type: string
          description: Market ID.
        marketSlug:
          type: string
          description: Market slug.
        eventSlug:
          type: string
          description: Event slug.
        conditionId:
          type: string
          description: Condition ID.
        marketTitle:
          type: string
          description: Market title.
        logo:
          type: string
          description: Market logo URL.
        closed:
          type: boolean
          description: Whether the position is closed.
        tokenId:
          type: string
          description: Token ID.
        positionSide:
          type: string
          description: >-
            Position side. Varies by market — e.g. `Yes` / `No` for binary
            markets, `Up` / `Down` for price direction markets.
          example: 'Yes'
        outcomeIndex:
          type: integer
          description: Outcome index.
          example: 0
        balance:
          type: string
          description: Remaining position balance (shares).
        avgPrice:
          type: string
          description: Average entry price, 0–1 scale.
        currentPrice:
          type: string
          description: Current price, 0–1 scale.
        avgExit:
          type: string
          description: Average exit price, 0–1 scale.
        totalInvested:
          type: string
          description: Total invested, in USD.
        totalBought:
          type: string
          description: Cumulative shares bought.
        value:
          type: string
          description: Current position value, in USD.
        unrealizedPnl:
          type: string
          description: Unrealized PnL, in USD.
        realizedPnl:
          type: string
          description: Realized PnL, in USD.
        totalPnl:
          type: string
          description: Realized + unrealized PnL, in USD.
        percentPnl:
          type: string
          nullable: true
          description: PnL as a percentage of cost basis.
        recentTradeTime:
          type: integer
          format: int64
          nullable: true
          description: Closing block timestamp (Unix seconds); `null` while open.
  responses:
    Unauthorized:
      description: The API key is missing or invalid.
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Missing or invalid API key
              status_code:
                type: string
                example: '0'
              data:
                type: 'null'
          example:
            message: Missing or invalid API key
            status_code: '0'
            data: null
  securitySchemes:
    bearerAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Pass your Orbscan API key as a Bearer token, formatted as `Bearer
        <your_api_key>`.

````