Skip to main content
GET
/
portfolio
/
positions
Get Positions
curl --request GET \
  --url https://api.limitless.exchange/portfolio/positions \
  --header 'X-API-Key: <api-key>'
{
  "rewards": {
    "todaysRewards": "50250000",
    "totalUnpaidRewards": "200750000",
    "totalUserRewardsLastEpoch": "150500000",
    "rewardsByEpoch": [
      {
        "epochId": 1,
        "timestamp": "2024-01-01T00:00:00.000Z",
        "totalRewards": "1500000",
        "userRewards": "150000",
        "earnedPercent": 0.1
      }
    ],
    "rewardsChartData": [
      {
        "timestamp": 1672531200000,
        "userRewards": "25000000",
        "totalRewards": "60000000"
      }
    ]
  },
  "points": 123,
  "accumulativePoints": 456,
  "amm": [
    {
      "market": {},
      "outcomeIndex": 0,
      "collateralAmount": "100500000",
      "latestTrade": {},
      "outcomeTokenAmount": "50250000",
      "account": "0x1234567890123456789012345678901234567890"
    }
  ],
  "clob": [
    {
      "market": {
        "address": "<string>",
        "title": "<string>",
        "proxyTitle": null,
        "description": "<string>",
        "question_id": {},
        "condition_id": {},
        "position_ids": [
          "<array>"
        ],
        "outcome_slot_count": 2,
        "winning_index": 0.5,
        "payout_numerators": [
          "<string>"
        ],
        "status": "<string>",
        "og_url": "<string>",
        "image_url": "<string>",
        "deadline": "<string>",
        "hidden": false,
        "txHash": null,
        "resolutionTxHash": null,
        "priority_index": null
      },
      "positions": {
        "yes": {
          "cost": "75000000",
          "fillPrice": "750000",
          "realisedPnl": "0",
          "unrealizedPnl": "25000000",
          "marketValue": "100000000"
        },
        "no": {
          "cost": "25000000",
          "fillPrice": "250000",
          "realisedPnl": "0",
          "unrealizedPnl": "-5000000",
          "marketValue": "20000000"
        }
      },
      "tokensBalance": {},
      "orders": {},
      "latestTrade": {},
      "rewards": {}
    }
  ],
  "group": [
    {}
  ]
}
For real-time position updates, use the WebSocket API — subscribe to subscribe_positions.
status: RESOLVED and winningOutcomeIndex indicate that the winning outcome is known in the API response. They do not guarantee that the underlying conditional token payout has already been settled on-chain or that the position is immediately redeemable. See Programmatic API - Lifecycle after a trade.

Authorizations

​
X-API-Key
string
header
required

API key for programmatic access. Generate at limitless.exchange -> profile menu -> Api keys.

Response

Complete portfolio positions with summary

​
rewards
object
required

Rewards information for the portfolio

​
points
number
required

User points

Example:

123

​
accumulativePoints
number
required

User accumulative points

Example:

456

​
amm
object[]
required

List of AMM positions

​
clob
object[]
required

List of CLOB positions

​
group
object[]

Grouped CLOB positions (if enabled)