---
search:
  tags:
    - RFQs
    - POST
seo:
  description: >-
    Creates a request for quote, soliciting pricing from market makers for one
    or more legs. Omit side… Reference for the POST /rfqs endpoint in the REST
    API API.
sidebar:
  badge: POST
  label: Create an RFQ
title: Create an RFQ
type: openapi-operation
---
Creates a request for quote, soliciting pricing from market makers for one or more legs. Omit side for a two-sided quote.

### Endpoint

- Method and path: `POST /rfqs`
- Operation ID: `createRfq`
- API reference: [POST /rfqs](/api-reference/rfqs/createrfq)

#### Authorization

- Accepted credentials: `UDX-Access-Key` header and `UDX-Access-Timestamp` header and `UDX-Access-Signature` header; or Bearer token in `Authorization`
- Details: [Authentication](/authentication)

#### Parameters

- `UDX-Version` (`header`) — Dated API version (YYYY-MM-DD). Omit to use the oldest supported version. An unknown version returns `400`.
- `UDX-Idempotency-Key` (`header`) — Optional client-generated key that makes a mutation safe to retry. Reuse it only for a byte-identical retry. When present, it is included in the request signature; omitting it disables UDX idempotency for that request.

#### Request body

- Content type: `application/json`
- Schema: `CreateRfqRequest`
- Required: yes
- Fields:
  - `client_rfq_id` (ClientId, required)
  - `ticker` — Market to request a quote for (single market, or an existing combo by its ticker). Provide exactly one of ticker or legs.
  - `legs` (array) — Component legs of the RFQ. A single leg is one market; multiple legs request the combined strategy. Provide exactly one of ticker or legs.
  - `quantity` — Number of contracts to quote, as a whole number. Provide exactly one of quantity or cash_quantity.
  - `cash_quantity` — Size of the RFQ in dollars. Provide exactly one of quantity or cash_quantity.
  - `side` — The side the customer wants to execute. Omit for a two-sided quote.
  - `account_id` — Account to create the RFQ under, by its UDX-assigned public entity identifier. Required for an unrestricted API key; an account-restricted key uses its bound account, and an account_id that names a different account is rejected.

#### Responses

- `201` — The created RFQ.
- `400` — The request doesn't conform to this spec.
- `401` — No valid credential was provided.
- `403` — The credential lacks the `trade` scope.
- `409` — This key is still in use or its response cannot be replayed. The mutation may have run; check `detail` before retrying.
- `422` — This key belongs to a different request.
- `429` — The Member's request rate is exhausted. Wait for `Retry-After`.
- `500` — Something went wrong on UDX's side.
- `503` — Request admission is unavailable. Retry later.