---
title: "Create Quote"
method: POST
path: "/v1/conversion/quote"
tags: ["Conversion"]
---

# Create Quote

`POST /v1/conversion/quote`

Create a new FX quote to be used for a conversion. The returned rate includes UQPAY's markup and reflects the final rate applicable within the quote's validity period.

#### Usage Guidelines

- A quote is required before executing a currency conversion or cross-currency payout.
- The generated quote must be used within its validity period (75 seconds), after which a new quote must be requested if needed.
- Specify both `buy_currency` and `sell_currency`, but define only one of either `buy_amount` or `sell_amount`. The defined amount represents the dealt (fixed) side, while the other amount will be automatically calculated based on UQPAY's exchange rate.
- A quote created with a specific `transaction_type` can only be used for the corresponding operation. Mixing usage is not allowed.
    - conversion quotes must be used with Create Conversion.
    - payout quotes must be used with Create Payout.

## Headers

- `x-on-behalf-of` string
- `x-idempotency-key` string, uuid

## Request body

- CreateQuoteRequest
  - `sell_currency` string, required — The currency being sold. For cross-currency payout scenarios, this should be the currency in the sender's account. Example: To pay out SGD from a USD account to a beneficiary, set `sell_currency = USD`.
  - `sell_amount` string — The amount of sell_currency.
  - `buy_currency` string, required — The currency being bought. For cross-currency payout scenarios, this should be the currency the beneficiary will receive. Example: To pay out SGD from a USD account to a beneficiary, set `buy_currency = SGD`.
  - `buy_amount` string — The amount of buy_currency.
  - `conversion_date` string, required — Specifies the scheduled date when the currency conversion will be executed. This should be a valid business day.
  - `transaction_type` 'conversion' | 'payout' — Type of transaction. - `conversion`: Default value. Used for currency conversion only. - `payout`: Used for cross-currency payouts only.

## Response `200`

OK - Successfully retrieved a payout.

- CreateQuoteResponse
  - `sell_currency` string, required — Currency code [ISO_4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes).
  - `sell_amount` string, required — The amount of sell_currency.
  - `buy_currency` string, required — Currency code [ISO_4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes).
  - `buy_amount` string, required — The amount of buy_currency.
  - `quote_price` QuotePrice, required
    - `currency_pair` string, required — The currency pair that the quote is for. The direction of the currency pair is per market convention where possible.
    - `direct_rate` string, required — The exchange rate from sell_currency to buy_currency.
    - `inverse_rate` string, required — The reciprocal of the direct_rate.
    - `quote_id` string, required — A unique UUID identifier for the quote.
    - `validity` object, required — Time window during which this quote remains valid.
      - `valid_from` integer, required — The timestamp from when the quote becomes valid.
      - `valid_to` integer, required — The timestamp indicating the quote's expiration time.

---

[API](https://skmtc.dev/uqpay/apis/authentication-api.md) · [All operations](https://skmtc.dev/uqpay/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uqpay/authentication-api/revisions/cef532a10777/schema)