Формат файла
экспорта курсов
На этой странице приведено описание стандарта для формирования экспортного файла курсов, поддерживаемого Рейтингом криптообменников Scanbit. Для добавления обменника вместе с другой информацией для включения необходимо предоставить службе поддержки Scanbit ссылку на экспортный файл, размещенный на вашем сайте. Пример содержимого такого файла см. ниже.
Основные правила:
Экспортный файл формируется в XML-формате;
Каждая запись идет с новой строки. Перенос осуществляется символом \n;
Для числовых значений разделителем целой части является точка;
Корневой элемент – <rates>;
Каждое направление обмена описывается в элементе <item>;
Обязательные к указанию элементы для описания направления обмена внутри элемента item:
<from> – код валюты, которую обменный пункт принимает от клиента. Коды валют доступны за ccылкой.
<to> – код валюты, которую обменный пункт отправляет клиенту. Коды валют доступны за ccылкой.
<in> – для указания курса обмена, сколько валюты from должен отдать клиент;
<out> – для указания курса обмена, сколько валюты to получит клиент
<amount> – размер резерва валюты to в обменном пункте, максимум, который может получить клиент;
<minamount> – минимальная возможная к обмену сумма валюты, которую обменный пункт принимает от клиента. Указывается в валюте from.
Пример <minamount>4.1</minamount> Если ограничений по минимальной сумме несколько, например, отдельно на прием и на выплату, необходимо указывать в поле minamount максимальное значение такого ограничения, сконвертированное в валюту from. Если нет возможности выбрать максимальное значение из нескольких значений минимальных сумм, необходимо указать дополнительные поля minamount с отдельной минимальной суммой в каждом
<maxamount> – максимальная возможная к разовому обмену сумма валюты, которую обменный пункт принимает от клиента. Указывается в валюте from.
Пример: <maxamount>5000</maxamount>
Если ограничений по максимальной сумме несколько, например, отдельно на прием и на выплату, необходимо указывать в поле maxamount минимальное значение такого ограничения, сконвертированное в валюту from. Если нет возможности выбрать минимальное значение из нескольких значений максимальных сумм, необходимо указать дополнительные поля maxamount с отдельной максимальной суммой в каждом.
Дополнительные элементы для описания направления обмена внутри элемента item:
<fromfee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую клиент переводит в обменный пункт. Указывается в валюте from.
Пример: <fromfee>2.15</fromfee> Возможно также использование знака % для обозначения процентной комиссии;
<tofee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую обменный пункт переводит клиенту. Указывается в валюте to.
Пример: <tofee>0.01508</tofee> Возможно также использование знака % для обозначения процентной комиссии;
<minfee> – минимальная комиссия, которая рассчитывается для разницы между отдаваемой суммой и эквивалентом получаемой валюты относительно среднего биржевого курса. Указывается абсолютное значение в валюте from. Процентное значение недоступно для данного вида комиссии.
Пример: <minfee>5</minfee> Внимание! Имейте в виду, что к дополнительным комиссиям fromfee и tofee комиссия minfee не имеет отношения, минимальная комиссия для отдаваемой или получаемой комиссии на данный момент никак не учитывается нашей системой, избегайте подобного формирования курса.
Примечание: дополнительная комиссия minfee имеет недостатки, в ближайшее время планируется удаление этого типа комиссии.
<delay> – для установки метки задержки в проведении обмена. Указывается время в минутах, на которое обмен будет задержан;
<param> – данный элемент служит для указания дополнительных меток.
Постоянные комиссии платежных систем не должны указываться в экспортном файле курсов. Наш мониторинг учитывает их самостоятельно.
<?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>
