List positions

curl "https://api.totalis.trade/v1/mm/positions?limit=20" \
  -H "X-API-Key: $API_KEY"

import requests

# Page through your live book and index positions by RFQ id.
positions, offset = {}, 0
while True:
    resp = requests.get(
        "https://api.totalis.trade/v1/mm/positions",
        headers={"X-API-Key": API_KEY},
        params={"limit": 100, "offset": offset},
    ).json()
    for p in resp["data"]["positions"]:
        positions[p["rfq_id"]] = p
    if not resp["meta"]["has_more"]:
        break
    offset += 100

{
  "data": {
    "positions": [
      {
        "position_pda": "7sKq9fGh2mNp4rTv6wXy8zAb1cDe3fGh5jKl7mNp9qRs",
        "position_id": "9f2c7a4e1b6d8305c4a9e7f21d8b306e",
        "rfq_id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
        "user_id": "did:privy:cmabc123def456ghi789jkl",
        "market_maker_id": "did:privy:cmxyz987uvw654rst321opq",
        "user_stake": 24.75,
        "mm_risk": 74.25,
        "mm_collateral_locked": 74.25,
        "total_payout": 99,
        "status": "active",
        "created_at": "2026-06-01T18:45:45.000Z",
        "legs": [
          {
            "market_title": "Lakers",
            "event_title": "NBA Finals Winner",
            "side": "yes",
            "outcome": "yes",
            "yes_sub_title": "Los Angeles Lakers",
            "no_sub_title": null,
            "selection_label": "Lakers",
            "bet_group": null,
            "venue": "kalshi",
            "event_ticker": "KXNBAFINALS-26",
            "market_ticker": "KXNBAFINALS-26-LAL",
            "exclusivity_group": "KXNBAFINALS-26",
            "exclusivity_group_kind": "partition",
            "venue_url": "https://kalshi.com/markets/kxnbafinals",
            "market_resolved": false,
            "market_result": null,
            "market_resolved_at": null
          }
        ]
      }
    ]
  },
  "meta": {
    "has_more": false,
    "limit": 20,
    "offset": 0
  }
}

GET

positions

curl "https://api.totalis.trade/v1/mm/positions?limit=20" \
  -H "X-API-Key: $API_KEY"

import requests

# Page through your live book and index positions by RFQ id.
positions, offset = {}, 0
while True:
    resp = requests.get(
        "https://api.totalis.trade/v1/mm/positions",
        headers={"X-API-Key": API_KEY},
        params={"limit": 100, "offset": offset},
    ).json()
    for p in resp["data"]["positions"]:
        positions[p["rfq_id"]] = p
    if not resp["meta"]["has_more"]:
        break
    offset += 100

{
  "data": {
    "positions": [
      {
        "position_pda": "7sKq9fGh2mNp4rTv6wXy8zAb1cDe3fGh5jKl7mNp9qRs",
        "position_id": "9f2c7a4e1b6d8305c4a9e7f21d8b306e",
        "rfq_id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
        "user_id": "did:privy:cmabc123def456ghi789jkl",
        "market_maker_id": "did:privy:cmxyz987uvw654rst321opq",
        "user_stake": 24.75,
        "mm_risk": 74.25,
        "mm_collateral_locked": 74.25,
        "total_payout": 99,
        "status": "active",
        "created_at": "2026-06-01T18:45:45.000Z",
        "legs": [
          {
            "market_title": "Lakers",
            "event_title": "NBA Finals Winner",
            "side": "yes",
            "outcome": "yes",
            "yes_sub_title": "Los Angeles Lakers",
            "no_sub_title": null,
            "selection_label": "Lakers",
            "bet_group": null,
            "venue": "kalshi",
            "event_ticker": "KXNBAFINALS-26",
            "market_ticker": "KXNBAFINALS-26-LAL",
            "exclusivity_group": "KXNBAFINALS-26",
            "exclusivity_group_kind": "partition",
            "venue_url": "https://kalshi.com/markets/kxnbafinals",
            "market_resolved": false,
            "market_result": null,
            "market_resolved_at": null
          }
        ]
      }
    ]
  },
  "meta": {
    "has_more": false,
    "limit": 20,
    "offset": 0
  }
}

List your active positions as the market maker, newest first, each with its full parlay legs. A position here is a trade where a user committed one of your quotes and you confirmed it. Use it to render your live book, reconcile exposure, or resolve an rfq_id you already hold (for example from Get vault) to its legs. The bettor-scoped RFQ reads are keyed to the user who placed the parlay and return 404 to you; this is the maker-side counterpart. Only active positions are returned, including in-flight release states (see status). Settled trades are not included. Base URL: https://api.totalis.trade

Authentication

API key required. Pass your API key in the X-API-Key header.

X-API-Key: <key>

Query parameters

integer

Page size. Default 20, maximum 100.

integer

Number of positions to skip, for offset-based pagination. Default 0.

string

Return only positions whose mm_risk falls in a size band: lt_10, 10_to_100, 100_to_1000, or gt_1000. Lower bounds are inclusive, upper bounds exclusive (10_to_100 matches 10 <= mm_risk < 100). Omit for no filter. An unrecognized value is ignored.

Response

object

Show data

array

Active positions, newest first.

Show position

string

On-chain position PDA.

string

On-chain position id, hex encoded (32 lowercase chars, no 0x). The early cashout join key: match it against the position_id on a broadcast cashout_request to see whether you back that position.

string

The RFQ (parlay ticket) id. Pass it to Get position. Matches the rfq_id from Get vault.

string

The counterparty bettor’s Privy DID (did:privy:...).

string

Your market maker Privy DID (did:privy:...).

number

The bettor’s net stake in USDC (bet_amount - taker_fee).

number

Your maximum risk (max loss) in USDC.

number | null

Collateral this position added to your lock when it opened, in USDC: the rise in your book’s worst-case loss, from 0 up to mm_risk. null before it lands. See Collateral and the ILP.

number

Total pot paid to the winner if the parlay resolves (user_stake + mm_risk).

string

active for a live position. expired_pending_mm_release, reconciling_mm_release, bought_back_pending_db, and reconciling_bought_back_db are in-flight release states; your collateral is still held in them.

string

ISO 8601 creation timestamp.

array

The parlay legs, in leg order.

Show leg

string

Per-market label (e.g. Lakers). May be null on legacy rows.

string

Parent event label (e.g. NBA Finals Winner). May be null on legacy rows.

string

The side taken on the leg: yes or no.

string

The bettor’s selected outcome for the leg.

string

Yes-side subtitle snapshot (team/option label). May be null.

string

No-side subtitle snapshot (team/option label). May be null.

string

Canonical pick label snapshotted at bet time. May be null.

string

Polymarket-only bucket/strike label (e.g. "$100k-$110k"). Null for Kalshi and single-market events.

string

Source venue: kalshi or polymarket.

string

Event-level ticker on the source venue.

string

Market-level ticker on the source venue.

string

Mutual-exclusivity key: legs sharing a value bet into a one-of-N outcome set. null when the leg is not in a group. This is a per-leg snapshot. To pre-check whether two markets can combine in a parlay, use the exclusion_keys arrays on GET /v1/markets/list.

string

How members of exclusivity_group relate: binary (strict two-outcome complements) or partition (one-of-N). null exactly when exclusivity_group is null.

string

Canonical URL of the leg’s market on its source venue. May be null.

boolean

true once the venue has a recognized result for this leg’s market.

string

Normalized market result: yes, no, or invalid. null while unresolved.

string

ISO 8601 time the venue resolved the market. null while unresolved.

object

Show meta

boolean

true when this page came back full, so more pages may exist. Offset pagination is approximate: the next page can still be empty, for example if positions settled between pages. Advance offset to fetch it.

integer

The effective page size applied.

integer

The offset applied.

Errors

Status	Code	Description
401	`UNAUTHORIZED`	Missing or invalid API key.

curl "https://api.totalis.trade/v1/mm/positions?limit=20" \
  -H "X-API-Key: $API_KEY"

import requests

# Page through your live book and index positions by RFQ id.
positions, offset = {}, 0
while True:
    resp = requests.get(
        "https://api.totalis.trade/v1/mm/positions",
        headers={"X-API-Key": API_KEY},
        params={"limit": 100, "offset": offset},
    ).json()
    for p in resp["data"]["positions"]:
        positions[p["rfq_id"]] = p
    if not resp["meta"]["has_more"]:
        break
    offset += 100

{
  "data": {
    "positions": [
      {
        "position_pda": "7sKq9fGh2mNp4rTv6wXy8zAb1cDe3fGh5jKl7mNp9qRs",
        "position_id": "9f2c7a4e1b6d8305c4a9e7f21d8b306e",
        "rfq_id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
        "user_id": "did:privy:cmabc123def456ghi789jkl",
        "market_maker_id": "did:privy:cmxyz987uvw654rst321opq",
        "user_stake": 24.75,
        "mm_risk": 74.25,
        "mm_collateral_locked": 74.25,
        "total_payout": 99,
        "status": "active",
        "created_at": "2026-06-01T18:45:45.000Z",
        "legs": [
          {
            "market_title": "Lakers",
            "event_title": "NBA Finals Winner",
            "side": "yes",
            "outcome": "yes",
            "yes_sub_title": "Los Angeles Lakers",
            "no_sub_title": null,
            "selection_label": "Lakers",
            "bet_group": null,
            "venue": "kalshi",
            "event_ticker": "KXNBAFINALS-26",
            "market_ticker": "KXNBAFINALS-26-LAL",
            "exclusivity_group": "KXNBAFINALS-26",
            "exclusivity_group_kind": "partition",
            "venue_url": "https://kalshi.com/markets/kxnbafinals",
            "market_resolved": false,
            "market_result": null,
            "market_resolved_at": null
          }
        ]
      }
    ]
  },
  "meta": {
    "has_more": false,
    "limit": 20,
    "offset": 0
  }
}

Overview

Quote service

Market maker

Markets

Parlays

Account

API keys

Funds and vault

Webhooks

Authentication

Query parameters

Response

Errors

​Authentication

​Query parameters

​Response

​Errors

Authentication

Query parameters

Response

Errors