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

fundingCurrencyPayoutFundingCurrencyquery

Stablecoin funding a fiat payout (USDC by default, or USDT), or the stablecoin a crypto payout is bought with; for the latter the estimate also prices that purchase the way creation will.

fundingNetworkNetworkquery

A balance to convert into what the payout needs (network of the funding asset). With `fundingToken`, the estimate also sizes that conversion, exchange fees included.

fundingTokenstringquery

Token contract of the funding asset; omit for a native asset

deliveryTokenstringquery

Token contract of the delivered asset for a crypto payout (`token` carries its ticker); omit for a native asset. Needed to size a conversion-funded estimate.

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

reservedFeeUsdnumber<float>nullable

For crypto payouts, what confirm reserves for the fee: the estimate plus padding. The final fee is settled on what the batches cost once they are sent, and the unused part of the reserve comes back.

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

minimumFundingUsdnumber<float>nullable

For fiat payouts, the smallest funding amount the bank off-ramp accepts, in funding units

estimatedFundingAmountnumber<float>nullable

For conversion-funded payouts: how much of the funding asset the conversion sells, exchange transfer fees and sizing buffer included

fundingTickerstringnullable

For conversion-funded payouts: the ticker of `estimated_funding_amount`

estimatedConversionCostUsdnumber<float>nullable

For conversion-funded payouts: what the conversion costs beyond the payout itself, in USD (exchange transfer fees, spread, buffer)

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