Portfolio & Positions

Overview

The PortfolioFetcher class retrieves your profile, open positions, and portfolio data from the Limitless Exchange API. It requires an authenticated HttpClient.

Setup

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

# Authenticate with a scoped API token (token ID + secret)
http_client = HttpClient(
    hmac_credentials=HMACCredentials(
        token_id=os.environ["LMTS_TOKEN_ID"],
        secret=os.environ["LMTS_TOKEN_SECRET"],
    ),
)
portfolio = PortfolioFetcher(http_client)

PortfolioFetcher requires an authenticated client. Pass scoped API-token credentials via hmac_credentials (as above), or use the root Client with the same credentials. A legacy LIMITLESS_API_KEY (X-API-Key) still works but is not recommended for new integrations.

Current Profile

Use get_current_profile() to fetch the authenticated caller’s private profile via GET /profiles/me. This is the preferred helper when the client is already authenticated and you do not want to pass a wallet address.

profile = await portfolio.get_current_profile()

print(profile["id"])       # numeric profile ID
print(profile["account"])  # authenticated wallet address
print(profile.get("rank", {}).get("feeRateBps"))

Use get_profile(address) only when you need the address-based route:

profile_by_address = await portfolio.get_profile("0xYOUR_WALLET_ADDRESS")

get_current_profile() calls GET /profiles/me; get_profile(address) calls GET /profiles/:account. Both return raw API responses matching the private profile schema.

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
import os
from limitless_sdk.api import HttpClient
from limitless_sdk import HMACCredentials
from limitless_sdk.portfolio import PortfolioFetcher

async def main():
    http_client = HttpClient(
        hmac_credentials=HMACCredentials(
            token_id=os.environ["LMTS_TOKEN_ID"],
            secret=os.environ["LMTS_TOKEN_SECRET"],
        ),
    )
    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())

Getting Started

Quick Start

TypeScript SDK

Python SDK

Go SDK

Rust SDK

WebSocket

Overview

Setup

Current Profile

Fetching Positions

Iterating CLOB Positions

Complete Example

​Overview

​Setup

​Current Profile

​Fetching Positions

​Iterating CLOB Positions

​Complete Example

Overview

Setup

Current Profile

Fetching Positions

Iterating CLOB Positions

Complete Example