---
title: "Exchange at market rate"
method: POST
path: "/exchange/now"
tags: ["Exchange"]
---

# Exchange at market rate

`POST /exchange/now`

Execute an exchange immediately at the currently available market rate, without requesting a fixed quote.

## Headers

- `X-Processing-Signature` string, required

## Request body

- object
  - `sender_currency` string, required — Currency to exchange from. For a list of all available currencies, see [API currency codes](/api-reference/currency-codes).
  - `receiver_currency` string, required — Currency to exchange to. For a list of all available currencies, see [API currency codes](/api-reference/currency-codes).
  - `sender_amount` number — Amount to send. You must include either this parameter or `receiver_amount`.
  - `receiver_amount` number — Amount to receive. You must include either this parameter or `sender_amount`.
  - `foreign_id` string, required — Unique exchange identifier in your system.

## Response `201`

Created

- object
  - `data` object
    - `sender_currency` string, required — The currency being exchanged from.
    - `sender_amount` string, required — If `sender_amount` was provided in the request, this is the requested send amount. If `receiver_amount` was provided, this is the calculated amount to send.
    - `receiver_currency` string, required — The currency being exchanged to.
    - `receiver_amount` string, required — If `receiver_amount` was provided in the request, this is the requested receive amount. If `sender_amount` was provided, this is the calculated amount to receive.
    - `fee_currency` string, required — The currency in which the exchange fee is charged.
    - `fee_amount` string, required — The exchange fee amount. If the fee is charged in the sender currency, the total debited amount is `sender_amount + fee_amount`.
    - `price` string, required — The exchange rate, expressed as units of `receiver_currency` for 1 unit of `sender_currency`.
    - `id` integer, required — Transaction ID.
    - `foreign_id` string, required — This exchange's unique identifier in your system.
    - `type` string, required — Transaction type.
    - `status` string, required — Exchange status.

## Other responses

- `400` — Bad Request.
- `403` — Forbidden

---

[API](https://skmtc.dev/cryptoprocessing/apis/merchant-backend-v2.md) · [All operations](https://skmtc.dev/cryptoprocessing/apis/merchant-backend-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cryptoprocessing/merchant-backend-v2/revisions/623a41f26c6b/schema)