---
title: "Request Quote (RFQ)"
method: POST
path: "/v1/quotes"
tags: ["Trading"]
---

# Request Quote (RFQ)

`POST /v1/quotes`

Request a quote for a currency conversion. Specify deliver quantity or receive quantity, but not both.

## Headers

- `X-Request-Id` string

## Request body

- union
  - object
    - `accountId` string, uuid, required
    - `pair` string, required
    - `side` 'BUY' | 'SELL', required
    - `deliverQuantity` string, nullable, required — One of 'deliverQuantity' or 'receiveQuantity' must be a positive value. The other must be null.
    - `clientFeeRate` string, integer, nullable — The client fee rate in bps.
    - `clientFeeAmount` string, number, nullable — Fixed fiat fee amount in tenant native currency. If both clientFeeRate and clientFeeAmount are provided, clientFeeRate takes precedence.
    - `clientReference` string — An optional free use reference field, typically used to correlate to the client's internal order.
  - object
    - `accountId` string, uuid, required
    - `pair` string, required
    - `side` 'BUY' | 'SELL', required
    - `receiveQuantity` string, nullable, required — One of 'deliverQuantity' or 'receiveQuantity' must be a positive value. The other must be null.
    - `clientFeeRate` string, integer, nullable — The client fee rate in bps.
    - `clientFeeAmount` string, number, nullable — Fixed fiat fee amount in tenant native currency. If both clientFeeRate and clientFeeAmount are provided, clientFeeRate takes precedence.
    - `clientReference` string — An optional free use reference field, typically used to correlate to the client's internal order.

## Response `200`

Successful response

- object
  - `quoteId` string, uuid
  - `requestedAt` string, date-time — Date-time in ISO 8601 format
  - `expiresAt` string, date-time — Date-time in ISO 8601 format
  - `accountId` string, uuid
  - `pair` string
  - `side` 'BUY' | 'SELL'
  - `deliverQuantity` string, number
  - `deliverCurrency` string
  - `receiveQuantity` string, number
  - `receiveCurrency` string
  - `price` string, number
  - `baseQuantity` string, number
  - `quoteQuantity` string, number
  - `feeCurrency` string
  - `clientFeeRate` string, integer, nullable — The client fee rate in bps.
  - `clientFeeAmount` string, number, nullable — Fixed fiat fee amount in tenant native currency. If both clientFeeRate and clientFeeAmount are provided, clientFeeRate takes precedence.
  - `clientFeeQuantity` string, float
  - `providerFeeRate` string, integer — The provider fee rate in bps.
  - `providerFeeQuantity` string, number
  - `quoteStatus` 'AWAITING_RESPONSE' | 'CANCELED' | 'EXPIRED' | 'ACCEPTED'
  - `clientReference` string, nullable
  - `tradeTaxRate` string, number
  - `clientTaxQuantity` string, number
  - `providerTaxQuantity` string, number

## Other responses

- `400` — Validation Error
- `401` — Unauthorized
- `403` — Insufficient Privileges
- `409` — Duplicate request error
- `4XX` — Client error
- `5XX` — Server error

---

[API](https://skmtc.net/aquanow/apis/aquanow-cams-rest-api.md) · [All operations](https://skmtc.net/aquanow/apis/aquanow-cams-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aquanow/aquanow-cams-rest-api/revisions/c62a02b27407/schema)