---
title: "Get currency exchange rates"
method: POST
path: "/currencies/rates"
tags: ["Currencies"]
---

# Get currency exchange rates

`POST /currencies/rates`

Get available currency pairs and exchange rates.

## Headers

- `X-Processing-Signature` string, required

## Request body

- object
  - `currency_from` string — Currency to exchange from. For a list of all available currencies, see [API currency codes](/api-reference/currency-codes).
  - `currency_to` string — Currency to exchange to. For a list of all available currencies, see [API currency codes](/api-reference/currency-codes).

## Response `200`

OK. Returns the available exchange pairs.

- object
  - `data` object[] — List of matching currency pairs.
    - `currency_from` object
      - `currency` string — Source currency code.
      - `type` 'crypto' | 'fiat' — Source currency type.
      - `min_amount` string — Minimum exchange amount for the source currency.
      - `min_amount_deposit_with_exchange` string — Minimum deposit amount when using exchange flow. Present when `currency_from.type` is `crypto`.
    - `currency_to` object
      - `currency` string — Target currency code.
      - `type` 'crypto' | 'fiat' — Target currency type.
    - `rate_from` string — Always `1`, representing one unit of `currency_from`.
    - `rate_to` string — Amount of `currency_to` equivalent to one unit of `currency_from`.

## Other responses

- `400` — Bad Request.
- `403` — Forbidden
- `422` — Unprocessable entity. An internal error occurred during processing. The request was understood but could not be completed. The `errors` field is an array of error messages. The `error_code` is always the string `"internal_error"`.

---

[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)