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

# Get fees for token amount

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

Computes the expected fees for a given token amount and payout fiat currency.

## Request body

- GetPayoutTokenFeesInput
  - `tokenFeeRequests` GetPayoutTokenFeeInput[], required — A specific token-to-fiat payout instance for which we will calculate the fees.
    - `amount` TokenAmount, required
      - `tokenAmount` number, required — The token amount.
      - `tokenSymbol` string, required — The token symbol.
    - `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.

## Response `200`

Payout fees for token amount

- union[]
  - union
    - TokenPayoutFeeSuccess
      - `estimatedFiatAmount` 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.
      - `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.
      - `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.
      - `tokenAmount` TokenAmount, required
        - `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
    - TokenPayoutFeeError
      - `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
      - `tokenAmount` TokenAmount, required
        - `tokenAmount` number, required — The token amount.
        - `tokenSymbol` string, required — The token symbol.
      - `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/revisions/437d277f5948/schema)