---
title: "Get Positions"
method: GET
path: "/portfolio/positions"
tags: ["Portfolio"]
---

# Get Positions

`GET /portfolio/positions`

Retrieve all active positions with P&L calculations and market values

## Response `200`

Complete portfolio positions with summary

- PortfolioPositionsDto
  - `rewards` PortfolioRewardsDto, required
    - `todaysRewards` string, required — Rewards earned today in token decimals
    - `totalUnpaidRewards` string, required — Total unpaid rewards in token decimals
    - `totalUserRewardsLastEpoch` string, required — Total user rewards from the last epoch in token decimals
    - `rewardsChartData` PortfolioRewardsChartEntryDto[] — Chart data showing rewards over time
      - `timestamp` number, required — Timestamp of the rewards entry
      - `userRewards` string, required — User rewards for this timestamp in token decimals
      - `totalRewards` string, required — Total rewards for this timestamp in token decimals
    - `rewardsByEpoch` EpochRewardDataDto[], required — Rewards data by epoch
      - `epochId` number, required — Unique identifier of the epoch
      - `timestamp` string, date-time, required — Timestamp when the epoch occurred
      - `totalRewards` string, required — Total rewards distributed in this epoch in token decimals
      - `userRewards` string, required — User rewards earned in this epoch in token decimals
      - `earnedPercent` number, required — Part of total rewards earned by the user - [0; 1]
  - `points` number, required — User points
  - `accumulativePoints` number, required — User accumulative points
  - `amm` AmmPositionDto[], required — List of AMM positions
    - `collateralAmount` string — Amount of collateral invested in token decimals
    - `latestTrade` object — Latest trade associated with this position
    - `market` object, required — Market information for this position
    - `outcomeIndex` number, required — Index of the outcome token
    - `outcomeTokenAmount` string — Amount of outcome tokens held in token decimals
    - `account` string — Wallet address that was used to create this position
  - `clob` ClobPositionDto[], required — List of CLOB positions
    - `market` Market, required
      - `address` string, nullable, required — The address of the FixedProductMarketMaker contract.
      - `title` string, required — Represents the question of the market, the title metadata of the market.
      - `proxyTitle` string, nullable, required
      - `description` string, required — The description of the market.
      - `question_id` object, nullable, required — The bytes32 parsed title of the market.
      - `condition_id` object, nullable, required — The bytes32 conditionId of the market, representing the conditions defined on condition preparation.
      - `position_ids` array[], nullable, required — Array of position IDs (max 2 elements)
        - unknown[]
          - unknown
      - `outcome_slot_count` number, required — The number of outcomes in the market.
      - `winning_index` number, nullable, required — The outcome index reported by the oracle. Indexes into the fixed `['Yes', 'No']` outcome array: `0` = YES resolved, `1` = NO resolved, `null` = not yet resolved.
      - `payout_numerators` string[], nullable, required — The oracle payout numerators that the oracle reported.
      - `status` string, required — Indicates the status of the market.
      - `og_url` string, nullable, required — The URL of the market OG image for SEO.
      - `image_url` string, nullable, required — The URL of the market logo image for SEO.
      - `deadline` string, required — The deadline of the market.
      - `startAt` string, date-time, nullable, required — The start time of the market.
      - `hidden` boolean, required
      - `txHash` string, required
      - `resolutionTxHash` string, required
      - `priority_index` number, required
    - `positions` MarketPositionDataDto, required
      - `yes` PositionDataDto, required
        - `cost` string, required — Cost basis of the position in token decimals (e.g. 1 USDC = 1000000)
        - `fillPrice` string, required — Average fill price of the position (price per share in token decimals)
        - `realisedPnl` string, required — Realized profit/loss from closed positions in token decimals
        - `unrealizedPnl` string, required — Unrealized profit/loss based on current market price in token decimals
        - `marketValue` string, required — Current market value of the position in token decimals
      - `no` PositionDataDto, required
        - `cost` string, required — Cost basis of the position in token decimals (e.g. 1 USDC = 1000000)
        - `fillPrice` string, required — Average fill price of the position (price per share in token decimals)
        - `realisedPnl` string, required — Realized profit/loss from closed positions in token decimals
        - `unrealizedPnl` string, required — Unrealized profit/loss based on current market price in token decimals
        - `marketValue` string, required — Current market value of the position in token decimals
    - `latestTrade` object — Latest trade prices
    - `tokensBalance` object, required — Token balances in token decimals
    - `orders` object, required — Order information
    - `rewards` object — Rewards information for this position
  - `group` object[] — Grouped CLOB positions (if enabled)

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/limitless/apis/limitless-exchange-api.md) · [All operations](https://skmtc.net/limitless/apis/limitless-exchange-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/limitless/limitless-exchange-api/versions/43f7d65e8e15/schema)