---
title: "Create Quote Request"
method: POST
path: "/quote-requests"
tags: ["Trading"]
---

# Create Quote Request

`POST /quote-requests`

Open a live quote request. The relay broadcasts the trade parameters to all connected market makers over the quote-request SSE stream and returns a `requestId` used to stream, poll, and commit. No wallet signature is required — the taker's authorization happens on-chain at `fill()`.

## Request body

- QuoteRequestInput
  - `wallet` string, nullable — Taker wallet (checksummed). Optional at creation; can be provided at commit.
  - `market` MarketInput, required
    - `conditionId` string, required — Polymarket condition ID (bytes32 hex).
    - `yesTokenId` string, required — Polymarket YES CLOB token ID (uint256 as string).
    - `question` string, required
  - `option` OptionInput, required
    - `strikeBps` number, required — Strike in basis points of $1 (5–95, step 5).
    - `expiryMs` number, required — Option expiry as a Unix timestamp in milliseconds.
    - `optionType` union, required — `"call"`/`0` for Call, `"put"`/`1` for Put.
      - 'call' | 'put'
      - 0 | 1
  - `trade` TradeInput, required — On a buy, the taker submits a USDC budget (`budgetUsd`) and the fill is `floor(budgetUsd / price)` whole options, capped by the maker's quoted size. On a sell, the taker submits a contract count (`size`).
    - `side` 'buy' | 'sell' | 'long' | 'short', required — `"buy"`/`"long"` or `"sell"`/`"short"`.
    - `budgetUsd` number — Buys only. USDC the taker will spend (premium budget). Contracts received = `floor(budgetUsd / price)`, capped by the maker's quoted size.
    - `size` number — Sells only. Number of whole options the taker wants to write.

## Response `200`

Quote request created

- QuoteRequestCreated
  - `success` true
  - `requestId` string
  - `expiresAt` string, date-time
  - `makersConnected` integer — Makers subscribed to the quote-request stream at broadcast time.

## Other responses

- `400` — Error

---

[API](https://skmtc.net/convallax/apis/convallax-rfq-api.md) · [All operations](https://skmtc.net/convallax/apis/convallax-rfq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convallax/convallax-rfq-api/versions/c8cb11b778c1/schema)