Network fees
Network fees are amounts that spenders may include in their on-chain transaction in order to have it included in a block.
There are three network fee levels available for coin withdrawal transactions.
network_fee_level
block
time
slow
7
~1 hour
average
3
~30 minutes
fast
1
~10 minutes
It is a very dynamic thing, therefore each level changes its value every minute in such a way as to guarantee that the transaction will be included in a specific block within a given time frame.
Use this API endpoint to get the list of network fee levels.
[
{
"level": "fast",
"fee": "0.00005612",
"currency": "BTC"
},
{
"level": "average",
"fee": "0.00004357",
"currency": "BTC"
},
{
"level": "slow",
"fee": "0.00004162",
"currency": "BTC"
}
]
The network fee level can be specified in a POST /api/coin_withdrawals
request body.
{
"charged_currency": "EUR",
"charged_amount_to_send": 10,
"address": "2N122JKRz52gokTmaVYNiMA43qvdSqnhLGV",
"received_currency": "BTC",
"network_fee_level": "fast"
}
How to separate processing and network fees
We’ve added a new way to define withdrawal amounts that allows you to separate processing and network fees. If you want to use this approach, replace these parameters: charged_amount
, received_amount
, and charged_amount_to_send
with the new ones:
amount
(decimal_string) — withdrawal amount specified by the user.amount_currency
(string, one of: charged_currency, received_currency) — currency of the specified amount.amount_includes_processing_fee
(bool) — indicates whether the amount includes the processing fee; can be true or false.amount_includes_network_fee
(bool) — indicates whether the amount includes the network fee; can be true or false.
Here are the example requests for each possible fee configuration:
Both fees are deducted from the transaction amount = amount paid by the recipient (end-user). This is the same as using
charged_amount
.
{
"address": "Cc6yDWNNCVMnauWPHW82Tp8BKCoAodzcrTji3yDeJXc8",
"charged_currency": "EUR",
"received_currency": "USDT",
"network": "solana",
"amount": "100.0",
"amount_currency": "EUR",
"amount_includes_processing_fee": true,
"amount_includes_network_fee": true,
"network_fee_level": "average",
"force_commit": true
}
Both fees are charged on top of the transaction amount = paid by the sender (= merchant). This is the same as using
charged_amount_to_send
.
{
"address": "Cc6yDWNNCVMnauWPHW82Tp8BKCoAodzcrTji3yDeJXc8",
"charged_currency": "EUR",
"received_currency": "USDT",
"network": "solana",
"amount": "100.0",
"amount_currency": "EUR",
"amount_includes_processing_fee": false,
"amount_includes_network_fee": false,
"network_fee_level": "average",
"force_commit": true
}
The network fee is included in the transaction amount (paid by the recipient), while the processing fee is charged on top of it (= paid by the sender)
{
"address": "Cc6yDWNNCVMnauWPHW82Tp8BKCoAodzcrTji3yDeJXc8",
"charged_currency": "EUR",
"received_currency": "USDT",
"network": "solana",
"amount": "100.0",
"amount_currency": "EUR",
"amount_includes_processing_fee": false,
"amount_includes_network_fee": true,
"network_fee_level": "average",
"force_commit": true
}
The processing fee is included in the transaction amount (paid by the recipient), while the network fee is charged on top of it (= paid by the sender)
{
"address": "Cc6yDWNNCVMnauWPHW82Tp8BKCoAodzcrTji3yDeJXc8",
"charged_currency": "EUR",
"received_currency": "USDT",
"network": "solana",
"amount": "100.0",
"amount_currency": "EUR",
"amount_includes_processing_fee": true,
"amount_includes_network_fee": false,
"network_fee_level": "average",
"force_commit": true
}
Last updated