---
title: "Get fees for fiat amount"
method: POST
path: "/api/payouts/fees/fiat-to-token"
tags: ["Payouts"]
---

# Get fees for fiat amount

`POST /api/payouts/fees/fiat-to-token`

Computes the estimated original token amount required and estimated fees for a recipient to receive the provided fiat currency amount.

## Request body

- GetPayoutFiatFeesInput
  - `fiatFeeRequests` GetPayoutFiatFeeInput[], required — A specific fiat-to-token payout instance for which we will calculate the fees.
    - `fiatAmount` number, required — The fiat amount you want to receive.
    - `fiatAndRailCode` 'usd' | 'cop' | 'cop-bre-b' | 'cop-cobre-balance' | 'ars' | 'eur' | 'mxn' | 'brl' | 'clp' | 'pen' | 'bob' | 'crc' | 'zar' | 'usd-peru' | 'usd-china' | 'usd-panama' | 'usd-hong-kong', required — The currency and if applicable, rail, that will be converted to.
    - `tokenSymbol` string, required — The token symbol you would be converting from

## Response `200`

Get payout fees for fiat amount

- union[]
  - union
    - FiatPayoutFeeSuccess
      - `estimatedTokenAmountRequired` TokenAmount, required
        - `tokenAmount` number, required — The token amount.
        - `tokenSymbol` string, required — The token symbol.
      - `exchangeFeePercentage` number, required — The total fee for the transaction (in percentile) applied at transaction execution time. This is applied to the source token amount.
      - `exchangeRate` number, required — The exchange rate for the transaction. The rate at which the token amount will be converted to fiat. The units are destination fiat per token.
      - `feeTotal` TokenAmount, required
        - `tokenAmount` number, required — The token amount.
        - `tokenSymbol` string, required — The token symbol.
      - `fiatAmount` SimpleFiatAmount, required
        - `fiatAmount` number, required — The fiat amount.
        - `fiatCurrencyCode` 'USD' | 'COP' | 'ARS' | 'EUR' | 'MXN' | 'BRL' | 'CLP' | 'PEN' | 'BOB' | 'CRC' | 'ZAR', required — The fiat currency code.
      - `fiatAndRailCode` 'usd' | 'cop' | 'cop-bre-b' | 'cop-cobre-balance' | 'ars' | 'eur' | 'mxn' | 'brl' | 'clp' | 'pen' | 'bob' | 'crc' | 'zar' | 'usd-peru' | 'usd-china' | 'usd-panama' | 'usd-hong-kong', required — The currency and if applicable, rail, that the token will be converted to.
      - `minTransactionValue` TokenAmount
        - `tokenAmount` number, required — The token amount.
        - `tokenSymbol` string, required — The token symbol.
      - `transactionFee` TokenAmount, required
        - `tokenAmount` number, required — The token amount.
        - `tokenSymbol` string, required — The token symbol.
      - `type` 'success', required
    - FiatPayoutFeeError
      - `fiatAndRailCode` 'usd' | 'cop' | 'cop-bre-b' | 'cop-cobre-balance' | 'ars' | 'eur' | 'mxn' | 'brl' | 'clp' | 'pen' | 'bob' | 'crc' | 'zar' | 'usd-peru' | 'usd-china' | 'usd-panama' | 'usd-hong-kong', required — The currency and if applicable, rail, that the token will be converted to.
      - `message` string, required — The error message explaining why the fee calculation failed
      - `tokenSymbol` string, required — The token symbol you want to exchange for the fiat amount.
      - `type` 'error', required

## Other responses

- `401` — Unauthorized
- `403` — SignedAgreementRequiredException

---

[API](https://skmtc.net/muralpay/apis/mural-api.md) · [All operations](https://skmtc.net/muralpay/apis/mural-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muralpay/mural-api/versions/437d277f5948/schema)