Quote requests in depth - Totalis

A quote request is the pre-trade price-discovery object (see the Glossary). For the full lifecycle, start with How parlays work.

Commit protection

Commit requires four fields. Together they make sure you lock in the price you actually saw.

Field	Type	Description
`expected_version`	integer	The quote request `version` you’re committing against. Rejected if the request was modified since your last update.
`displayed_quote_id`	string	The `id` of the best quote you were shown.
`displayed_quote_book_seq`	integer	The `book_seq` from the SSE event that delivered the quote. Proves your pricing was current.
`min_payout_odds_seen`	number	The minimum payout odds you saw. Only quotes at or above this threshold can be selected.

{
  "expected_version": 3,
  "displayed_quote_id": "quote-uuid",
  "displayed_quote_book_seq": 5,
  "min_payout_odds_seen": 4.0
}

Rejection codes

If a commit fails, error.details.reason tells you why. Each reason and what to do about it is on Errors.

SSE event format

Events on the user stream (/v1/quote-requests/{id}/stream) look like this:

{
  "book_seq": 5,
  "version": 3,
  "best_quote": {
    "id": "quote-uuid",
    "payout_odds": 4.0,
    "user_cost": 24.75,
    "total_payout": 99,
    "mm_cost": 74.25,
    "valid_until": "2026-06-01T18:45:45.000Z"
  }
}

When no quotes are active, best_quote is null. Store book_seq and best_quote.id from the latest event. You send them as displayed_quote_book_seq and displayed_quote_id when you commit.

Quote request object

{
  "id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
  "version": 3,
  "request_hash": "sha256...",
  "book_seq": 5,
  "status": "active",
  "bet_amount": 25,
  "expires_at": "2026-06-01T18:45:30.000Z",
  "legs": [
    {
      "id": "8ccf2c5d-...",
      "market_ticker": "KXBTC-26JUN05-T73500",
      "side": "yes",
      "venue": "kalshi"
    }
  ],
  "input_legs": [
    { "market_ticker": "KXBTC-26JUN05-T73500", "side": "yes", "venue": "kalshi" }
  ]
}