Формат файлу
експорту курсів
Команда Scanbit допомагає здійснювати зручний та безпечний обмін криптовалюти і власноруч перевіряє кожен обмінний сервіс. Перед включенням обмінника до рейтингу ми просимо заповнити форму та надати нашій службі підтримки посилання на експортний файл курсів, розміщенний на сайті криптообмінника. Правила оформлення експортного файлу та відповіді на часті запитання наводимо нижче.
Основні правила
Файл експорту курсів необхідно сформувати у форматі XML;
Кожен запис повинен розташовуватись на новому рядку. Для переносу використовується символ \n
Для відділення цілої частини у числових значеннях використовується крапка;
Кореневий елемент – <rates>;
Кожен напрямок обміну необхідно описувати в елементі <item>;
Обов'язкові елементи для опису напрямку обміну всередині елемента item:
<from> – код валюти, яку обмінник приймає від клієнта. Коди валют досупні за посиланням.
<to> – код валюти, яку обмінник надсилає клієнту. Коди валют доступні за посиланням.
<in> – для вказівки курсу обміну, скільки валюти повинен віддати клієнт;
<out> – для вказівки курсу обміну, скільки валюти отримає клієнт;
<amount> – розмір резерву валюти в обмінному пункті, максимум, який може отримати клієнт;
<minamount> – мінімальна можлива для обміну сума валюти, яку обмінний пункт приймає від клієнта. Вказується у валюті from.
Приклад: <minamount>4.1</minamount> Якщо обмежень за мінімальною сумою кілька, наприклад, окремо на прийом та виплату, необхідно вказувати в полі minamount максимальне значення такого обмеження, сконвертоване у валюту від. Якщо немає можливості вибрати максимальне значення із кількох значень мінімальних сум, необхідно вказати додаткові поля minamount з окремою мінімальною сумою в кожному.<maxamount> – максимальна можлива до одноразового обміну сума валюти, яку обмінний пункт приймає від клієнта. Вказується у валюті from.
Приклад: <maxamount>5000</maxamount> Якщо обмежень по максимальній сумі кілька, наприклад, окремо на прийом і виплату, необхідно вказувати в полі maxamount мінімальне значення такого обмеження, сконвертоване у валюту від. Якщо немає можливості вибрати мінімальне значення із кількох значень максимальних сум, необхідно вказати додаткові поля 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>