Формат файла
экспорта курсов

На этой странице приведено описание стандарта для формирования экспортного файла курсов, поддерживаемого Рейтингом криптообменников Scanbit. Для добавления обменника вместе с другой информацией для включения необходимо предоставить службе поддержки Scanbit ссылку на экспортный файл, размещенный на вашем сайте. Пример содержимого такого файла см. ниже.

Основные правила:

  1. Экспортный файл формируется в XML-формате;

  2. Каждая запись идет с новой строки. Перенос осуществляется символом \n;

  3. Для числовых значений разделителем целой части является точка;

  4. Корневой элемент – <rates>;

  5. Каждое направление обмена описывается в элементе <item>;

  6. Обязательные к указанию элементы для описания направления обмена внутри элемента 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 с отдельной максимальной суммой в каждом.

  7. Дополнительные элементы для описания направления обмена внутри элемента item:

    • <fromfee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую клиент переводит в обменный пункт. Указывается в валюте from.

      Пример: <fromfee>2.15</fromfee> Возможно также использование знака % для обозначения процентной комиссии;

    • <tofee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую обменный пункт переводит клиенту. Указывается в валюте to.

      Пример: <tofee>0.01508</tofee> Возможно также использование знака % для обозначения процентной комиссии;

    • <minfee> – минимальная комиссия, которая рассчитывается для разницы между отдаваемой суммой и эквивалентом получаемой валюты относительно среднего биржевого курса. Указывается абсолютное значение в валюте from. Процентное значение недоступно для данного вида комиссии.

      Пример: <minfee>5</minfee> Внимание! Имейте в виду, что к дополнительным комиссиям fromfee и tofee комиссия minfee не имеет отношения, минимальная комиссия для отдаваемой или получаемой комиссии на данный момент никак не учитывается нашей системой, избегайте подобного формирования курса.

      Примечание: дополнительная комиссия minfee имеет недостатки, в ближайшее время планируется удаление этого типа комиссии.

    • <delay> – для установки метки задержки в проведении обмена. Указывается время в минутах, на которое обмен будет задержан;

    • <param> – данный элемент служит для указания дополнительных меток.

  8. Постоянные комиссии платежных систем не должны указываться в экспортном файле курсов. Наш мониторинг учитывает их самостоятельно.

Пример
<?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>
Ссылка на примерный экспортный файл курсов
FAQ
Наш экспортный файл обновляется раз в минуту через Cron. Достаточно ли такой периодичности?
Файл курсов не парсится, Scanbit выдает ошибку. Что можно проверить?
Какие комиссии должны передаваться в экспортном файле?
Наш обменный пункт имеет ступенчатые курсы обмена, которые изменяются в зависимости от суммы обмена. Как указать это в экспорте?