> ## Documentation Index
> Fetch the complete documentation index at: https://docs.totalis.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Quote Request

> Retrieve a quote request with all active quotes and the current best quote.

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](/api-reference/quote-service/stream) instead.

## Authentication

API key required. Pass your API key in the `X-API-Key` header. The key needs the `positions:read` scope.

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

A Privy JWT (`Authorization: Bearer <jwt>`) is also accepted — see [Authentication](/guides/authentication).

## Path parameters

<ParamField path="id" type="string" required>
  The quote request ID (UUID).
</ParamField>

## Response

<ResponseField name="data" type="object">
  <Expandable title="data">
    <ResponseField name="quote_request" type="object">
      The quote request object including `id`, `version`, `status`, `bet_amount`, `legs`, and `expires_at`.
    </ResponseField>

    <ResponseField name="quotes" type="array">
      All active quotes for the current version.

      <Expandable title="Quote object">
        <ResponseField name="id" type="string">Quote UUID.</ResponseField>
        <ResponseField name="market_maker_id" type="string">The quoting market maker's ID.</ResponseField>
        <ResponseField name="payout_odds" type="number">Payout multiplier on the bet amount.</ResponseField>
        <ResponseField name="user_cost" type="number">Cost to the user in USDC.</ResponseField>
        <ResponseField name="total_payout" type="number">Total payout if the parlay wins.</ResponseField>
        <ResponseField name="mm_cost" type="number">USDC the market maker puts at risk.</ResponseField>
        <ResponseField name="valid_until" type="string">ISO 8601 timestamp when this quote expires.</ResponseField>
        <ResponseField name="leg_prices" type="array">Per-leg pricing with `leg_id` and `leg_odds`.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="best_quote" type="object">
      The quote with the highest payout odds, or `null` if no quotes are active.
    </ResponseField>
  </Expandable>
</ResponseField>

## Errors

| Status | Code           | Description                        |
| ------ | -------------- | ---------------------------------- |
| 401    | `UNAUTHORIZED` | Missing or invalid API key.        |
| 403    | `FORBIDDEN`    | You do not own this quote request. |
| 404    | `NOT_FOUND`    | Quote request not found.           |

<RequestExample>
  ```bash theme={null}
  curl https://api.totalis.trade/v1/quote-requests/1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40 \
    -H "X-API-Key: $TOTALIS_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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"
      }
    }
  }
  ```
</ResponseExample>