---
title: "Calculate guaranteed FX quote"
method: POST
path: "/irt/v1/quote/calculate"
tags: ["IRT"]
---

# Calculate guaranteed FX quote

`POST /irt/v1/quote/calculate`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `ApiKey`, `MerchantId`, `Environment`

Returns a guaranteed FX quote valid for 30 minutes. Requires fx_quote_create permission. Behind ENABLE_FX_ENGINE flag.

## Headers

- `ApiKey` string, required
- `MerchantId` string, required
- `Environment` 'live' | 'sandbox', required

## Request body

- FxQuoteRequestDto
  - `inputCurrency` string, required: Input currency (send side), ISO 4217 code
  - `corridor` string, required: Corridor code
  - `amount` string, required: Amount in the input currency as a positive decimal string (at most 2 decimals)
  - `provider` string: Mobile-money operator paying out, in lowercase, as `recipient.provider` when funding. Required on a mobile-wallet corridor (`provider_required`), refused on a bank-transfer corridor (`provider_not_allowed`). Funding the quote for another operator is refused with `quote_provider_mismatch`.

## Response `200`

- FxQuoteResponseDto
  - `rateId` string, required
  - `exchangeRate` string, required
  - `outputAmount` string, required: Amount the recipient receives, priced on the full amount quoted. The Hub2 fee is charged on top and never reduces it.
  - `hub2Fee` string, required: Hub2 fee for this transaction, charged in addition to the amount sent.
  - `quoteExpiresAt` string, required
  - `lastUpdated` string, required

## Other responses

- `400`: Bad Request
- `401`: Wrong credentials
- `404`: `corridor_not_found`: the corridor is not in the catalogue.
- `429`: ThrottlerException: Too Many Requests
- `500`: Internal error
- `503`: Service unavailable

## Changes

- **2026-11-03** `f6d3f87df5e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hub2/apis/hub2-service-api/changes/irt/v1/quote/calculate/post.md)

---

[API](https://skmtc.dev/hub2/apis/hub2-service-api.md) - [All operations](https://skmtc.dev/hub2/apis/hub2-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hub2/apis/hub2-service-api/revisions/f6d3f87df5e0?raw)