Skip to main content

Get payout fee estimate

GEThttps://api.radom.com/payout/fee

Returns the fee structure and estimated fee for a payout based on the organization's fee configuration, the destination currency, and the amount.

Authorization

Send your API key in the Authorization header. Scheme: radomToken.

Parameters

currencyCurrencyqueryrequired

The currency of the fiat payout (e.g. eur, usd, gbp, mxn, brl)

amountnumber<float>queryrequired

The payout amount

amountModePayoutAmountModequery

Whether amount is the recipient fiat amount or the source USDC debit amount

accountTypestringquery

Account type: "business" or "individual"

networkNetworkquery

For crypto payouts: network

tokenstringquery

For crypto payouts: token contract address

Responses

200Payout fee estimate
feePercentnumber<float>required

The percentage fee (e.g. 0.01 = 1%)

flatFeeUsdnumber<float>required

The flat fee in USD

minimumFeeUsdnumber<float>nullable

The minimum fee in USD, when configured

estimatedFeeUsdnumber<float>required

The estimated total fee in USD for the given amount

estimatedFundingAmountUsdnumber<float>nullable

For fiat payouts, estimated USDC funding required before the visible payout fee

estimatedTotalDebitUsdnumber<float>nullable

For fiat payouts, estimated total USDC debit including funding and visible payout fee

estimatedRecipientAmountnumber<float>required

The estimated amount the recipient receives (amount - estimated_fee)

exchangeRatenumber<float>nullable

For fiat payouts, the customer-facing fiat-per-USDC rate with Radom FX margin baked in

networkFeeUsdnumber<float>nullable

Network fee in USD (for crypto payouts only)

400Bad Request
errorstringrequired
401Unauthorized
errorstringrequired
500Internal server error
errorstringrequired