Commit Quote Request

curl -X POST https://api.totalis.trade/v1/quote-requests/1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40/commit \
  -H "X-API-Key: $TOTALIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 3,
    "displayed_quote_id": "b2c3d4e5-6789-0abc-def1-234567890abc",
    "displayed_quote_book_seq": 5,
    "min_payout_odds_seen": 4.25
  }'

{
  "data": {
    "status": "committed",
    "quote_request_id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
    "rfq_id": "c3d4e5f6-7890-abcd-ef12-34567890abcd",
    "quote_id": "d4e5f6a7-8901-bcde-f234-567890abcdef",
    "selected_payout_odds": 4.25,
    "confirmation_deadline": "2026-06-01T18:45:35.000Z"
  }
}

POST

quote-requests

{id}

commit

curl -X POST https://api.totalis.trade/v1/quote-requests/1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40/commit \
  -H "X-API-Key: $TOTALIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 3,
    "displayed_quote_id": "b2c3d4e5-6789-0abc-def1-234567890abc",
    "displayed_quote_book_seq": 5,
    "min_payout_odds_seen": 4.25
  }'

{
  "data": {
    "status": "committed",
    "quote_request_id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
    "rfq_id": "c3d4e5f6-7890-abcd-ef12-34567890abcd",
    "quote_id": "d4e5f6a7-8901-bcde-f234-567890abcdef",
    "selected_payout_odds": 4.25,
    "confirmation_deadline": "2026-06-01T18:45:35.000Z"
  }
}

Commit the best available quote on an active quote request. The server revalidates all markets, selects the best quote that meets your min_payout_odds_seen threshold, and creates the trade atomically. The request body includes fields that tie the commit to exactly what you last saw, preventing stale-price execution. After a successful commit, the selected market maker receives a quote:accepted event and must confirm the trade before the confirmation_deadline. It may also receive mm_quote:accepted on its private mm:quotes:{mm_id} channel, with the final quote economics and exact exposure legs for immediate local risk reservation. From there, the vault settlement flow takes over.

Authentication

API key required. Pass your API key in the X-API-Key header. The key needs the trading:write scope.

X-API-Key: <your-api-key>

A Privy JWT (Authorization: Bearer <jwt>) is also accepted — see Authentication.

Path parameters

string

required

The quote request ID (UUID).

Request body

integer

required

The quote request version you are committing against. The commit is rejected if the version has changed since you last received it, indicating the request was modified.

string

required

The id of the best quote you saw at commit time.

integer

required

The book_seq value from the SSE event that delivered the displayed quote. Proves your data was up to date.

number

required

The minimum payout odds you were shown. Only quotes at or above this threshold are eligible. Must be at least 1.0001.

Response

object

Show data

string

"committed"

string

The quote request ID.

string

The created RFQ ID for vault settlement.

string

The selected quote ID.

number

The payout odds that were locked in.

string

ISO 8601 deadline by which the market maker must confirm.

Rejection reasons

When a commit is rejected with 409 Conflict, the error.details.reason field explains why:

Reason	Description
`QUOTE_CHANGED`	The `expected_version` does not match. The request was updated since you last fetched it.
`MARKET_NOT_LIVE`	One or more markets are no longer available (expired, halted, or delisted).
`QUOTE_EXPIRED`	No active quotes exist, or the best quote expired between selection and commit.
`COMMIT_FAILED`	The commit could not be completed — for example no eligible market maker had sufficient collateral. Returns `409`.
`COMMIT_FAILED_RETRYABLE`	Transient error. Retry after a short delay. Returns `503`.

Errors

Status	Code	Description
400	`VALIDATION_ERROR`	Missing or invalid commit fields.
401	`UNAUTHORIZED`	Missing or invalid API key.
403	`FORBIDDEN`	You do not own this quote request.
404	`NOT_FOUND`	Quote request not found.
409	`CONFLICT`	Commit rejected. See `error.details.reason` above.
503	`SERVICE_UNAVAILABLE`	Transient failure. Retry after a short delay.

curl -X POST https://api.totalis.trade/v1/quote-requests/1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40/commit \
  -H "X-API-Key: $TOTALIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 3,
    "displayed_quote_id": "b2c3d4e5-6789-0abc-def1-234567890abc",
    "displayed_quote_book_seq": 5,
    "min_payout_odds_seen": 4.25
  }'

{
  "data": {
    "status": "committed",
    "quote_request_id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
    "rfq_id": "c3d4e5f6-7890-abcd-ef12-34567890abcd",
    "quote_id": "d4e5f6a7-8901-bcde-f234-567890abcdef",
    "selected_payout_odds": 4.25,
    "confirmation_deadline": "2026-06-01T18:45:35.000Z"
  }
}

Get Quote Request Cancel Quote Request

⌘I

Overview

Quote service

Market maker

Markets

Parlays

Account

API keys

Funds & vault

Webhooks

Commit Quote Request

Authentication

Path parameters

Request body

Response

Rejection reasons

Errors

​Authentication

​Path parameters

​Request body

​Response

​Rejection reasons

​Errors

Authentication

Path parameters

Request body

Response

Rejection reasons

Errors