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

# Request Quote (RFQ)

`POST /v1/quotes`

## Request

- Base URL: `https://cams.aquanow.com/api`
- URL: `https://cams.aquanow.com/api/v1/quotes`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/aquanow/apis/aquanow-cams-rest-api/docs/v1/quotes/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/aquanow/apis/aquanow-cams-rest-api.md) - [All operations](https://skmtc.dev/aquanow/apis/aquanow-cams-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aquanow/apis/aquanow-cams-rest-api/revisions/c62a02b27407?raw)