Skip to main content
GET
/
v1
/
quote-requests
/
{id}
curl https://api.totalis.trade/v1/quote-requests/1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40 \
  -H "Authorization: Bearer $TOKEN"

{
  "data": {
    "quote_request": {
      "id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
      "version": 3,
      "request_hash": "sha256:a3f4b2c...",
      "book_seq": 5,
      "status": "active",
      "bet_amount": 25,
      "legs": [
        {
          "id": "8ccf2c5d-3a61-4707-93f2-b6f0a0f0c0c6",
          "event_ticker": "KXBTC-26JUN01",
          "market_ticker": "KXBTC-26JUN01-T72500",
          "side": "yes",
          "venue": "kalshi"
        }
      ],
      "input_legs": [
        {"market_ticker": "KXBTC-26JUN01-T72500", "side": "yes", "venue": "kalshi"}
      ],
      "expires_at": "2026-06-01T18:45:30.000Z"
    },
    "quotes": [
      {
        "id": "b2c3d4e5-6789-0abc-def1-234567890abc",
        "market_maker_id": "mm-uuid-1234",
        "payout_odds": 4.25,
        "user_cost": 25,
        "total_payout": 106.25,
        "mm_cost": 81.25,
        "valid_until": "2026-06-01T18:45:45.000Z",
        "leg_prices": [
          {"leg_id": "8ccf2c5d-3a61-4707-93f2-b6f0a0f0c0c6", "leg_odds": 0.42}
        ]
      }
    ],
    "best_quote": {
      "id": "b2c3d4e5-6789-0abc-def1-234567890abc",
      "payout_odds": 4.25,
      "user_cost": 25,
      "total_payout": 106.25,
      "mm_cost": 81.25,
      "valid_until": "2026-06-01T18:45:45.000Z"
    }
  }
}
Retrieve a quote request by ID. The response includes the full quote request object, all active quotes for the current version, and the computed best quote (highest payout odds). Use this endpoint to check the current state of a quote request. For real-time updates, use the SSE stream instead.

​
Authentication

Bearer token required. Pass your JWT in the Authorization header. 
Authorization: Bearer <jwt>

​
Path Parameters

​
id
string
required
The quote request ID (UUID).

​
Response

​
data
object

​
Errors

StatusCodeDescription
401UNAUTHORIZEDMissing or invalid JWT.
403FORBIDDENYou do not own this quote request.
404NOT_FOUNDQuote request not found.
curl https://api.totalis.trade/v1/quote-requests/1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40 \
  -H "Authorization: Bearer $TOKEN"

{
  "data": {
    "quote_request": {
      "id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
      "version": 3,
      "request_hash": "sha256:a3f4b2c...",
      "book_seq": 5,
      "status": "active",
      "bet_amount": 25,
      "legs": [
        {
          "id": "8ccf2c5d-3a61-4707-93f2-b6f0a0f0c0c6",
          "event_ticker": "KXBTC-26JUN01",
          "market_ticker": "KXBTC-26JUN01-T72500",
          "side": "yes",
          "venue": "kalshi"
        }
      ],
      "input_legs": [
        {"market_ticker": "KXBTC-26JUN01-T72500", "side": "yes", "venue": "kalshi"}
      ],
      "expires_at": "2026-06-01T18:45:30.000Z"
    },
    "quotes": [
      {
        "id": "b2c3d4e5-6789-0abc-def1-234567890abc",
        "market_maker_id": "mm-uuid-1234",
        "payout_odds": 4.25,
        "user_cost": 25,
        "total_payout": 106.25,
        "mm_cost": 81.25,
        "valid_until": "2026-06-01T18:45:45.000Z",
        "leg_prices": [
          {"leg_id": "8ccf2c5d-3a61-4707-93f2-b6f0a0f0c0c6", "leg_odds": 0.42}
        ]
      }
    ],
    "best_quote": {
      "id": "b2c3d4e5-6789-0abc-def1-234567890abc",
      "payout_odds": 4.25,
      "user_cost": 25,
      "total_payout": 106.25,
      "mm_cost": 81.25,
      "valid_until": "2026-06-01T18:45:45.000Z"
    }
  }
}