Portfolio & Positions

Track positions and history with the Python SDK

Overview

The PortfolioFetcher class retrieves your open positions and portfolio data from the Limitless Exchange API. It requires an authenticated HttpClient with a valid API key.

Setup

from limitless_sdk.api import HttpClient
from limitless_sdk.portfolio import PortfolioFetcher

http_client = HttpClient()  # loads LIMITLESS_API_KEY from env
portfolio = PortfolioFetcher(http_client)

PortfolioFetcher requires an authenticated client. Ensure your API key is set via the LIMITLESS_API_KEY environment variable or the api_key parameter on HttpClient.

Fetching Positions

Use get_positions() to retrieve all your open positions:

positions = await portfolio.get_positions()

The response is a dictionary with the following top-level keys:

Key	Type	Description
clob	list[dict]	Positions on CLOB (order book) markets
amm	list[dict]	Positions on AMM (automated market maker) markets
accumulativePoints	dict	Accumulated points and rewards data

Iterating CLOB Positions

Each entry in the clob list contains the market details and your position size:

positions = await portfolio.get_positions()

for pos in positions.get("clob", []):
    market_title = pos["market"]["title"]
    size = pos["size"]
    outcome = pos.get("outcomeIndex", "N/A")
    print(f"{market_title} — size: {size}, outcome index: {outcome}")

Example response structure

{
    "clob": [
        {
            "market": {
                "title": "BTC above 100k by March 2025?",
                "slug": "btc-above-100k-march-2025",
            },
            "size": "15.5",
            "outcomeIndex": 0,
            # ... additional fields
        },
        # ... more positions
    ],
    "amm": [
        # ... AMM positions
    ],
    "accumulativePoints": {
        # ... points data
    },
}

The PortfolioFetcher returns raw API responses without heavy parsing or transformation. Field names and types match the REST API directly. Refer to the API Reference for the complete response schema.

Complete Example

import asyncio
from limitless_sdk.api import HttpClient
from limitless_sdk.portfolio import PortfolioFetcher

async def main():
    http_client = HttpClient()
    portfolio = PortfolioFetcher(http_client)

    positions = await portfolio.get_positions()

    clob_positions = positions.get("clob", [])
    amm_positions = positions.get("amm", [])

    print(f"CLOB positions: {len(clob_positions)}")
    for pos in clob_positions:
        print(f"  {pos['market']['title']} — size: {pos['size']}")

    print(f"\nAMM positions: {len(amm_positions)}")
    for pos in amm_positions:
        print(f"  {pos['market']['title']} — size: {pos['size']}")

    points = positions.get("accumulativePoints", {})
    print(f"\nAccumulative points: {points}")

    await http_client.close()

asyncio.run(main())