---
title: "Create an exchange quote with a currency pair"
method: POST
path: "/fx/exchange"
tags: ["fx"]
---

# Create an exchange quote with a currency pair

`POST /fx/exchange`

## Request body

- ExchangeQuoteRequest
  - `amount` number, double, required — String encoded decimal number
  - `pair` string, required — Currency pair in ISO-4217 format, where the first currency is the source and the second is the target.

## Response `201`

Quote created successfully

- ExchangeQuoteResponse
  - `id` string, uuid, required — Unique identifier for the quote
  - `amount` number, float, required — The original amount
  - `net_amount` number, float, required — Amount after fees or deductions
  - `target_amount` number, float, required — Amount in the target currency
  - `currency` string, required — ISO-4217 code of the source currency
  - `target_currency` string, required — ISO-4217 code of the target currency
  - `expires_at` string, date-time, required — Datetime when the quote expires (UTC)

## Other responses

- `400` — Bad Request - Invalid input or malformed data
- `401` — Unauthorized access due to missing or invalid API key
- `403` — Permission denied for the requested action.
- `404` — The requested resource does not exist.
- `405` — The HTTP method used is not allowed for this endpoint.
- `406` — The Accept header cannot be satisfied.
- `415` — The request's content type is not supported.
- `429` — Too many requests, the request has been throttled.
- `500` — A generic internal API error occurred.

---

[API](https://skmtc.net/prometeoapi/apis/account-validation-v2.md) · [All operations](https://skmtc.net/prometeoapi/apis/account-validation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prometeoapi/account-validation-v2/revisions/9c278fe91cbd/schema)