---
title: "Get Quotes"
method: GET
path: "/communications/quotes"
tags: ["communications"]
---

# Get Quotes

`GET /communications/quotes`

## Request

- Base URL: `https://external-api.kalshi.com/trade-api/v2`
- URL: `https://external-api.kalshi.com/trade-api/v2/communications/quotes`
- Auth: API key in header `KALSHI-ACCESS-KEY` and API key in header `KALSHI-ACCESS-SIGNATURE` and API key in header `KALSHI-ACCESS-TIMESTAMP`

List quotes. The rfq_id filter requires an RFQ UUID. Pass pagination cursors back unchanged; malformed RFQ IDs or cursors return HTTP 400.

## Query parameters

- `cursor` string
- `min_ts` integer
- `max_ts` integer
- `limit` integer
- `status` string
- `quote_creator_user_id` string
- `user_filter` 'self': Omit or leave empty to return all results. Use `self` to filter by the authenticated user.
- `rfq_user_filter` 'self': Omit or leave empty to return all results. Use `self` to filter by the authenticated user.
- `rfq_creator_user_id` string
- `rfq_creator_subtrader_id` string
- `rfq_id` string

## Response `200`

Quotes retrieved successfully

- GetQuotesResponse
  - `quotes` Quote[], required: List of quotes matching the query criteria
    - `id` string, required: UUID of the quote. Preserve the exact returned string.
    - `rfq_id` string, required: UUID of the RFQ this quote is responding to.
    - `creator_id` string, required: Public communications ID of the quote creator
    - `rfq_creator_id` string, required: Public communications ID of the RFQ creator (pseudonymous). When obscure_creator_id is enabled, other users receive the shared placeholder "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" (SHA-256 of empty input). The creator sees their normal ID. After this quote executes successfully, its counterparty sees the normal public communications ID.
    - `market_ticker` string, required: The ticker of the market this quote is for
    - `contracts_fp` string, required: Fixed-point contract count string (2 decimals, e.g., "10.00"; referred to as "fp" in field names). Requests accept 0-2 decimal places (e.g., "10", "10.0", "10.00"); responses always emit 2 decimals. Fractional contract values (e.g., "2.50") are supported; the minimum granularity is 0.01 contracts.
    - `yes_bid_dollars` string, required: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `no_bid_dollars` string, required: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `created_ts` string, date-time, required: Timestamp when the quote was created
    - `updated_ts` string, date-time, required: Timestamp when the quote was last updated
    - `status` 'open' | 'accepted' | 'confirmed' | 'executed' | 'cancelled', required: Current status of the quote
    - `accepted_side` 'yes' | 'no': The side that was accepted (yes or no)
    - `accepted_ts` string, date-time: Timestamp when the quote was accepted
    - `confirmed_ts` string, date-time: Timestamp when the quote was confirmed
    - `executed_ts` string, date-time: Timestamp when the quote was executed
    - `cancelled_ts` string, date-time: Timestamp when the quote was cancelled
    - `rest_remainder` boolean: Whether to rest the remainder of the quote after execution
    - `post_only` boolean: Whether the quote creator's order is post-only (visible when the caller is the quote creator)
    - `cancellation_reason` string: Reason for quote cancellation if cancelled
    - `creator_user_id` string: User ID of the quote creator (private field)
    - `rfq_creator_user_id` string: User ID of the RFQ creator (private field)
    - `rfq_target_cost_dollars` string: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `target_cost_excludes_fees` boolean: True when the RFQ's target cost is principal-only and the contracts-offered sizes were computed without reserving taker fees (fees are charged on top of the target cost).
    - `rfq_creator_order_id` string: Order ID for the RFQ creator (private field)
    - `creator_order_id` string: Order ID for the quote creator (private field)
    - `creator_subaccount` integer: Subaccount number of the quote creator (visible when the caller is the quote creator)
    - `rfq_creator_subaccount` integer: Subaccount number of the RFQ creator (visible when the caller is the RFQ creator)
    - `yes_contracts_fp` string: Fixed-point contract count string (2 decimals, e.g., "10.00"; referred to as "fp" in field names). Requests accept 0-2 decimal places (e.g., "10", "10.0", "10.00"); responses always emit 2 decimals. Fractional contract values (e.g., "2.50") are supported; the minimum granularity is 0.01 contracts.
    - `no_contracts_fp` string: Fixed-point contract count string (2 decimals, e.g., "10.00"; referred to as "fp" in field names). Requests accept 0-2 decimal places (e.g., "10", "10.0", "10.00"); responses always emit 2 decimals. Fractional contract values (e.g., "2.50") are supported; the minimum granularity is 0.01 contracts.
  - `cursor` string: Cursor for pagination to get the next page of results

## Other responses

- `400`: Bad request - invalid input
- `401`: Unauthorized - authentication required
- `500`: Internal server error

## Changes

- **2026-09-15** `75098a17c536`: 1 info
  - added the non-success response with the status `400`
- **2026-09-08** `c68a2add4c0a`: 1 info
  - added the optional property `quotes/items/target_cost_excludes_fees` to the response with the `200` status
- **2026-07-31** `a07481be8bf9`: 2 warning
  - removed the optional property `service` from the response with the `401` status
  - removed the optional property `service` from the response with the `500` status
- **2026-07-13** `a671b3e77f35`: 2 warning
  - deleted the `query` request parameter `event_ticker`
  - deleted the `query` request parameter `market_ticker`
- **2026-06-17** `5dacc8874900`: 2 info
  - added the new optional `query` request parameter `max_ts`
  - added the new optional `query` request parameter `min_ts`

[Operation history](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/changes/communications/quotes/get.md)

---

[API](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints.md) - [All operations](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/revisions/e6691cdd1915?raw)