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

# Poll Quotes

> Poll for the latest market maker quotes on an open quote request. Returns the current best quote and total count.

Poll for the current best quote submitted by market makers on an open quote request.

<Info>
  The preferred transport for live pricing is the SSE stream [`GET /quote-requests/{id}/stream`](/api-reference/trading/stream), which pushes an update only when the best quote changes. This poll endpoint **still exists as a fallback** for clients that cannot use Server-Sent Events.
</Info>


## OpenAPI

````yaml api-reference/openapi.json GET /quote-requests/{id}/quotes
openapi: 3.1.0
info:
  title: Convallax RFQ API
  version: 3.0.0
  description: >-
    REST surface for the Convallax options protocol — a non-custodial
    request-for-quote marketplace for European calls and puts on Polymarket YES
    outcomes, settled on Polygon.


    **Wire format**: JSON. Successful responses include `"success": true`;
    failures return `{ "success": false, "error": "..." }`.


    **Authentication**: Takers (traders) need no API key — authorization happens
    on-chain at `fill()`. Market makers authenticate with a per-MM API key sent
    as `X-API-Key` (or `?apiKey=`).


    **Streaming**: Quote-request and live-pricing streams use Server-Sent Events
    and the post-trade channel uses WebSocket; those are documented in the
    guides and are not part of this request/response reference.
servers:
  - url: https://api.convallax.com
    description: Production
security: []
tags:
  - name: Series
    description: Browse registered option series available for trading.
  - name: Trading
    description: Open quote requests, read live quotes, and commit to the best price.
  - name: Market Maker
    description: >-
      Submit quotes and confirmation signatures. Authenticated with a per-MM API
      key.
  - name: Settlement
    description: Compute TWAP resolution prices and sign settlement attestations.
  - name: Testnet
    description: Polygon Amoy testnet USDC faucet.
  - name: User
    description: >-
      Account profile and self-serve API keys. Authenticated with a Privy access
      token.
paths:
  /quote-requests/{id}/quotes:
    get:
      tags:
        - Trading
      summary: Poll Quotes
      description: >-
        Poll for the current best quote on an open quote request. Prefer the SSE
        stream `GET /quote-requests/{id}/stream` for live pricing; this endpoint
        is a fallback for clients that cannot use Server-Sent Events.
      operationId: pollQuotes
      parameters:
        - $ref: '#/components/parameters/RequestId'
      responses:
        '200':
          description: Current best quote
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuotesPollResponse'
        '404':
          $ref: '#/components/responses/Error'
components:
  parameters:
    RequestId:
      name: id
      in: path
      required: true
      description: The `requestId` returned by Create Quote Request.
      schema:
        type: string
        example: req-789
  schemas:
    QuotesPollResponse:
      type: object
      properties:
        success:
          type: boolean
          const: true
        bestQuote:
          oneOf:
            - $ref: '#/components/schemas/Quote'
            - type: 'null'
          description: Current best quote, or null if none received.
        quoteCount:
          type: integer
          example: 3
        status:
          type: string
          enum:
            - open
            - accepted
            - confirmed
            - closed
          example: open
        closed:
          type: boolean
          example: false
    Quote:
      type: object
      description: A market maker quote as exposed to takers.
      properties:
        maker_id:
          type: string
          description: Identifier of the market maker.
          example: mm-alpha
        quote_id:
          type: string
          description: Server-generated quote ID.
          example: 8f3c2b1a-1d2e-4c3b-9a8f-6e5d4c3b2a1f
        maker:
          type: string
          description: Maker wallet address (becomes `Order.maker`).
          example: '0x1234000000000000000000000000000000abcd'
        side:
          type: string
          enum:
            - buy
            - sell
          example: buy
        price:
          type: number
          description: Price per option in (0, 1).
          example: 0.12
        size:
          type: number
          example: 10
        expires_in_ms:
          type: number
          example: 5000
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          const: false
        error:
          type: string
          description: Human-readable error message.
          example: Quote request not found or expired
  responses:
    Error:
      description: Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'

````