Fees
Fees are incoming and outgoing. If the fee increases the amount of the incoming currency, then this is the incoming fee, and if the fee decreases the amount of the outgoing currency then this is the outgoing fee. Also, there are currency fees and exchanges fees. If the availability of the fee is determined by a particular currency, then this is the currency fee, and if the fee depends on the particular exchange, then this is the exchange fee.
Currency fees, like currency reserves, are indicated as a list of such pairs currency number: fees. As the currency number, you need to specify the number under which the currency is indicated in the list of currencies. As a fee, you need to specify the incoming and/or outgoing fee. Incoming fee are specified in in, and outgoing in out. If both fees are the same, then simply specify the value of one of them.
Exchange fees are specified along with the exchange rate. Incoming fee are spicified in inFee, and outgoing in outFee.
Exchange fees take precedence over currency fees. For example, if the incoming currency fee and the incoming exchange fee are specified, only the incoming exchange fee will be taken into account.
Fees must be in one of the formats described below.
Floating fees should be included in the rate, this will reduce the size of the export file.
The following fees are shown in the example below:
- 1% + 50 incoming and outgoing fee, for all exchanges with the participation of Alfa-Bank RUB
- 0.0001 Bitcoin outgoing fee, for all exchanges involving Bitcoin
- 50 Alfa-Bank RUB outgoing fee, only for exchanging Perfect Money USD to Alfa-Bank RUB, 1% + 50 currency fee is not taken into account
Fees formats
Fees are inherently such:
- fixed – these are fees that are specify as a number;
- floating – these are fixed fees, with a percent sign at the end;
- combined – these are fees that consist of 2 different fees (most often floating and fixed);
- multiple – these are fees whose amount differs for different amounts.
The table below shows the formats and examples of all fees.
Spaces in formats and examples are not needed, here they are specified only for the convenience of their perception.
| Fee | Format | Example | |
|---|---|---|---|
| fixed | number | 50 | |
| floating | ["%", number] | ["%", 3.1] | 3.1% |
| combined | ["+", fee1, fee2] | ["+", ["%", 3.1], 50] | 3.1% + 50 |
| multiple |
[ "*", { "amount 1": fee, ... "amount N": fee } ] |
[ "*", { "0": ["%", 2], "1000": ["%", 1] } ] |
2% for amounts less than 1000, and 1% for amounts from 1000 and more |
Minimum and maximum fees values
If the amount of the fee should not be less or more than a certain number, then this number is the minimum or maximum value of the fee. They can be specified for any fees, except for fixed. The table below shows the formats and examples of specifing these values.
Spaces in formats and examples are not needed, here they are specified only for the convenience of their perception.
| Value | Format | Example | |
|---|---|---|---|
| minimum | ["<", fee, min.] | ["<", ["%", 1], 1] | the amount of fee should be at least 1 |
| maximum | [">", fee, max.] | [">", ["%", 1], 150] | the amount of the fee can be a maximum of 150 |
| minimum and maximum | ["|", fee, min., max.] | ["|", ["%", 1], 1, 150] | the amount of fee should be more than 1 but not more than 150 |