Rate Export
File Format
This page provides a description of the standard for generating an export rate file supported by the Scanbit Rating Crypto Exchange. To add an exchanger along with other information, you must provide Scanbit support with a link to an export file hosted on your site. See below for an example of such file contents.
Basic Rules:
The export file is generated in XML-format;
Each entry starts on a new line. The transfer is carried out by the symbol \n;
For numeric values, the integer separator is a dot;
Root element – <rates>;
Each exchange direction is described in the element <item>;
Required elements to describe the direction of exchange within the element item:
<from> – the currency code accepted by the exchanger from the client. Currency codes are available at the link.
<to> – the currency code that the exchanger sends to the client. Currency codes are available at the link.
<in> – to specify the exchange rate, how much of the "from" currency the client should give;
<out> – to specify the exchange rate, how much currency "to" the client will receive;
<amount> – the amount of the currency reserved "to" at the exchanger, the maximum that the client can receive;
<minamount> – the minimum amount of currency that can be exchanged, which the exchanger accepts from the client. Indicated in currency "from".
Example:
<minamount>4.1</minamount> If there are several restrictions on the minimum amount, for example, separately for receiving and for paying out, it is necessary to indicate in the minamount field the maximum value of such a restriction, converted into the currency "from". If it is not possible to select the maximum value from several minimum amounts, you must specify additional minamount fields with a separate minimum amount in each.<maxamount> – the maximum possible amount of currency for a one-time exchange, which the exchanger accepts from the client. Specified in the currency "from".
Example: <maxamount>5000</maxamount>
If there are several restrictions on the maximum amount, for example, separately for receiving and for withdrawal, it is necessary to indicate in the maxamount field the minimum value of such a restriction, converted into the currency "from". If it is not possible to select the minimum value from several maximum amount values, you must specify additional maxamount fields with a separate maximum amount in each.
Additional elements to describe the direction of exchange within the "item" element:
<fromfee> – an additional commission that is not included in the exchange rate and is charged on the amount that the client transfers to the exchange office. Indicated in currency "from".
Example: <fromfee>2.15</fromfee> It is also possible to use the % sign to indicate a percentage commission;
<tofee> – an additional commission that is not included in the exchange rate and charged on the amount that the exchange office transfers to the client. Specified in currency "to".
Example: <tofee>0.01508</tofee> It is also possible to use the % sign to indicate a percentage commission;
<minfee> – the minimum commission, which is calculated for the difference between the amount given and the equivalent of the received currency relative to the average exchange rate. Specifies the absolute value in the currency "from". The percentage value is not available for this type of commission.
Example: <minfee>5</minfee> Keep in mind that the minfee commission has nothing to do with the additional fromfee and tofee commissions, the minimum commission for the commission given or received is not taken into account by our system at the moment, avoid such formation of the rate.
Note: The minfee additional fee has disadvantages, this type of fee is planned to be removed in the near future.
<delay> – to set the delay mark in the exchange. Specifies the time in minutes for which the exchange will be delayed;
<param> – this element is used to specify additional marks.
Permanent commissions of payment systems should not be specified in the export rate file. Our monitoring takes them into account independently.
<?xml version="1.0"?> <rates> <item> <from>WMZ</from> <to>WMX</to> <in>1</in> <out>30.593562</out> <amount>572962.42</amount> <minamount>3</minamount> <maxamount>1000</maxamount> </item> <item> <from>ADVCUSD</from> <to>PMUSD</to> <in>1</in> <out>0.978</out> <amount>2921.42</amount> <minamount>2</minamount> <maxamount>2000</maxamount> <minfee>7</minfee> <param>manual</param> </item> <item> <from>BTC</from> <to>ETH</to> <in>1</in> <out>24.90782568</out> <amount>673.10</amount> <minamount>0.0001</minamount> <maxamount>0.42341216</maxamount> <tofee>1%</tofee> <param>manual, reg</param> </item> <item> <from>BTC</from> <to>CASHUSD</to> <in>1</in> <out>4342.352344</out> <amount>31.90343295</amount> <minamount>1.5</minamount> <maxamount>1000</maxamount> <minfee>5</minfee> <city>ANKR</city> </item> </rates>