List Quotes

curl "https://api.totalis.trade/v1/mm/quotes?status=accepted&limit=50" \
  -H "X-API-Key: $API_KEY"

import requests

# Reconcile on startup or after a WebSocket drop: confirm any
# committed quote you haven't confirmed yet.
resp = requests.get(
    "https://api.totalis.trade/v1/mm/quotes",
    headers={"X-API-Key": API_KEY},
    params={"status": "accepted"},
)
for quote in resp.json()["data"]["quotes"]:
    requests.post(
        f"https://api.totalis.trade/v1/mm/quotes/{quote['id']}/confirm",
        headers={"X-API-Key": API_KEY},
    )

{
  "data": {
    "quotes": [
      {
        "id": "d4e5f6a7-8901-bcde-f234-567890abcdef",
        "parlay_ticket_id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
        "market_maker_id": "mm-uuid-1234",
        "payout_odds": 4.25,
        "user_cost": 25,
        "total_payout": 106.25,
        "mm_cost": 81.25,
        "taker_fee": 0,
        "valid_until": "2026-06-01T18:45:45.000Z",
        "status": "accepted",
        "created_at": "2026-06-01T18:45:30.000Z",
        "updated_at": "2026-06-01T18:45:30.000Z",
        "mm_wallet_address": "7sKq...9fGh"
      }
    ]
  },
  "meta": {
    "cursor": null,
    "has_more": false
  }
}

GET

quotes

curl "https://api.totalis.trade/v1/mm/quotes?status=accepted&limit=50" \
  -H "X-API-Key: $API_KEY"

import requests

# Reconcile on startup or after a WebSocket drop: confirm any
# committed quote you haven't confirmed yet.
resp = requests.get(
    "https://api.totalis.trade/v1/mm/quotes",
    headers={"X-API-Key": API_KEY},
    params={"status": "accepted"},
)
for quote in resp.json()["data"]["quotes"]:
    requests.post(
        f"https://api.totalis.trade/v1/mm/quotes/{quote['id']}/confirm",
        headers={"X-API-Key": API_KEY},
    )

{
  "data": {
    "quotes": [
      {
        "id": "d4e5f6a7-8901-bcde-f234-567890abcdef",
        "parlay_ticket_id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
        "market_maker_id": "mm-uuid-1234",
        "payout_odds": 4.25,
        "user_cost": 25,
        "total_payout": 106.25,
        "mm_cost": 81.25,
        "taker_fee": 0,
        "valid_until": "2026-06-01T18:45:45.000Z",
        "status": "accepted",
        "created_at": "2026-06-01T18:45:30.000Z",
        "updated_at": "2026-06-01T18:45:30.000Z",
        "mm_wallet_address": "7sKq...9fGh"
      }
    ]
  },
  "meta": {
    "cursor": null,
    "has_more": false
  }
}

List every quote of yours that reached the committed trade lifecycle, newest first. A quote appears here when a user commits one of your quote service drafts: it arrives in accepted status, moves to confirmed when you confirm it, or ends expired if the confirmation window lapses. This is your reconciliation read. If your WebSocket connection drops and you miss a quote:accepted event, poll with status=accepted and confirm anything still open — a quote whose window already lapsed rejects the confirm with 409, so a late attempt is safe. Base URL: https://api.totalis.trade

Authentication

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

X-API-Key: <key>

Query parameters

status

string

Return only quotes in this status. One of accepted, confirmed, expired, pending, executed, rejected, withdrawn — in the current flow you will see accepted, confirmed, and expired. An unrecognized value is ignored and the response is unfiltered.

rfq_id

string

Return only quotes on this RFQ (UUID).

limit

integer

Page size. Default 50, maximum 100.

cursor

string

Opaque pagination cursor. Pass the meta.cursor value from the previous page to fetch the next one.

Response

data

object

Show data

quotes

array

Quotes ordered newest first.

Show quote

string

Quote UUID. Matches quote_id on the quote:accepted and mm_quote:accepted WebSocket events.

parlay_ticket_id

string

The RFQ this quote belongs to. Matches the rfq_id filter.

market_maker_id

string

Your market maker ID.

payout_odds

number

The payout multiplier you quoted.

user_cost

number

Cost to the user in USDC.

total_payout

number

Total payout in USDC if the parlay wins.

mm_cost

number

Your risk in USDC (total_payout - user_cost).

taker_fee

number

Taker fee locked on the quote in USDC. 0 while the taker fee is off.

valid_until

string

ISO 8601 timestamp when the quote’s pricing validity ended.

status

string

Lifecycle status: accepted (committed by the user, awaiting your confirmation), confirmed (locked in), or expired (confirmation window lapsed and the trade unwound).

created_at

string

ISO 8601 creation timestamp.

updated_at

string

ISO 8601 timestamp of the last status change.

mm_wallet_address

string

Your wallet address backing the quote’s collateral. May be omitted.

Errors

Status	Code	Description
400	`VALIDATION_ERROR`	`rfq_id` is not a valid UUID.
401	`UNAUTHORIZED`	Missing or invalid API key.

curl "https://api.totalis.trade/v1/mm/quotes?status=accepted&limit=50" \
  -H "X-API-Key: $API_KEY"

import requests

# Reconcile on startup or after a WebSocket drop: confirm any
# committed quote you haven't confirmed yet.
resp = requests.get(
    "https://api.totalis.trade/v1/mm/quotes",
    headers={"X-API-Key": API_KEY},
    params={"status": "accepted"},
)
for quote in resp.json()["data"]["quotes"]:
    requests.post(
        f"https://api.totalis.trade/v1/mm/quotes/{quote['id']}/confirm",
        headers={"X-API-Key": API_KEY},
    )

{
  "data": {
    "quotes": [
      {
        "id": "d4e5f6a7-8901-bcde-f234-567890abcdef",
        "parlay_ticket_id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
        "market_maker_id": "mm-uuid-1234",
        "payout_odds": 4.25,
        "user_cost": 25,
        "total_payout": 106.25,
        "mm_cost": 81.25,
        "taker_fee": 0,
        "valid_until": "2026-06-01T18:45:45.000Z",
        "status": "accepted",
        "created_at": "2026-06-01T18:45:30.000Z",
        "updated_at": "2026-06-01T18:45:30.000Z",
        "mm_wallet_address": "7sKq...9fGh"
      }
    ]
  },
  "meta": {
    "cursor": null,
    "has_more": false
  }
}

Decline Cashout Confirm Quote

⌘I

Overview

Quote service

Market maker

Markets

Parlays

Account

API keys

Funds & vault

Webhooks

Authentication

Query parameters

Response

Errors

​Authentication

​Query parameters

​Response

​Errors

Authentication

Query parameters

Response

Errors