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:

1. 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
}

1. 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
}

1. 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
}

1. 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
}