Get Payout Fees

Before creating a Payout Request, you can fetch the fees (for the purposes of displaying to your end-user) associated with a prospective Payout Request. We have two endpoints in the Payouts API for this.

You can either specify the source tokenAmount (the source USDC) or the destination fiatAmount.

📘
Note
The destination fiat currency amount returned is the live / real-time exchange rate, but it is not locked until a payout is executed.

Example requests

curl --request POST \
     --url http://app.muralpay.com/api/payouts/fees/token-to-fiat \
     --header 'accept: application/json' \
     --header 'authorization: Bearer $API-KEY' \
     --header 'content-type: application/json' \
     --data '
{
  "tokenFeeRequests": [
    {
      "amount": {
        "tokenAmount": 100,
        "tokenSymbol": "USDC"
      },
      "fiatAndRailCode": "cop"
    }
  ]
}
'

curl --request POST \
     --url http://app.muralpay.com/api/payouts/fees/fiat-to-token \
     --header 'accept: application/json' \
     --header 'authorization: Bearer $API-KEY' \
     --header 'content-type: application/json' \
     --data '
{
  "fiatFeeRequests": [
    {
      "fiatAndRailCode": "cop",
      "fiatAmount": 100,
      "tokenSymbol": "USDC",
    }
  ]
}
'

Example response

[
    {
        "type": "success",
        "tokenSymbol": "USDC",
        "fiatAndRailCode": "cop",
        "exchangeRate": 3108.613065,
        "exchangeFeePercentage": 1.4,
        "minTransactionValue": {
            "tokenAmount": 1.35,
            "tokenSymbol": "USDC"
        },
        "transactionFee": {
            "tokenAmount": 0.35,
            "tokenSymbol": "USDC"
        },
        "estimatedFiatAmount": {
            "fiatAmount": 305421.23,
            "fiatCurrencyCode": "COP"
        },
        "tokenAmount": {
            "tokenAmount": 100,
            "tokenSymbol": "USDC"
        }
    }
]

[
    {
        "type": "success",
        "tokenSymbol": "USDC",
        "fiatAndRailCode": "cop",   
        "exchangeRate": 3108.613065,
        "exchangeFeePercentage": 1.4,
        "minTransactionValue": {
            "tokenAmount": 1.35,
            "tokenSymbol": "USDC"
        },      
        "fiatAmount": {
            "fiatAmount": 100,
            "fiatCurrencyCode": "COP"
        },
        "estimatedTokenAmountRequired": {
            "tokenAmount": 0.38,
            "tokenSymbol": "USDC"
        },
        "transactionFee": {
            "tokenAmount": 0.35,
            "tokenSymbol": "USDC"
        }
    }
]