Format pliku
kursy eksportowe
Zespół Scanbit pomaga przeprowadzić wygodną i bezpieczną wymianę kryptowalut oraz osobiście sprawdza każdą usługę wymiany. Przed włączeniem wymiennika do rankingu prosimy o wypełnienie formularza i przekazanie naszemu działowi pomocy technicznej linku do pliku z eksportem kursu wymiany zamieszczonego na stronie internetowej wymiennika kryptowalut. Poniżej znajdują się zasady tworzenia pliku eksportu oraz odpowiedzi na najczęściej zadawane pytania.
Podstawowe zasady:
Plik eksportu kursu musi być utworzony w formacie XML;
Każdy wpis musi znajdować się w nowym wierszu. Znak \n służy do przewozu
Kropka służy do oddzielenia całej części w wartościach liczbowych;
Elementem głównym jest <rates>;
Każdy kierunek wymiany musi być opisany w elemencie <item>;
Elementy obowiązkowe do opisu kierunku wymiany wewnątrz elementu pozycji::
<from> – kod waluty, który wymiennik akceptuje od klienta. Kody walut są dostępne pod linkiem.
<to> – kod waluty, który wymiennik wysyła do klienta. Kody walut są dostępne pod linkiem.
<in> – aby wskazać kurs wymiany, ile waluty klient musi podać;
<out> – oaby wskazać kurs wymiany, ile waluty otrzyma klient;
<amount> – wielkość rezerwy walutowej w punkcie wymiany, maksimum, jakie klient może otrzymać;
<minamount> – minimalna możliwa do wymiany kwota waluty, którą kantor przyjmuje od klienta. Podana jest w walucie from.
Przykład
<minamount>4.1</minamount> Jeżeli istnieje kilka ograniczeń dotyczących kwoty minimalnej, np. osobno dla odbioru i płatności, konieczne jest wskazanie w polu minamount maksymalnej wartości takiego ograniczenia, przeliczonej na walutę od . Jeśli nie jest możliwe wybranie wartości maksymalnej spośród wielu wartości kwot minimalnych, należy określić dodatkowe pola minmount z osobną kwotą minimalną w każdym z nich.
<maxamount> – maksymalna możliwa kwota waluty, którą kantor przyjmuje od klienta przed jednorazową wymianą. Podana jest w walucie from.
Przykład: <maxamount>5000</maxamount>
Jeżeli istnieje kilka limitów maksymalnej kwoty, np. oddzielnie dla paragonu i płatności, minimalna wartość takiego limitu przeliczona na walutę od, musi być wskazana w polu maxamount. Jeśli nie jest możliwe wybranie wartości minimalnej z wielu wartości kwot maksymalnych, należy określić dodatkowe pola maxamount z oddzielną kwotą maksymalną w każdym.
Dodatkowe elementy opisujące kierunek wymiany wewnątrz elementu pozycji:
<fromfee> – to dodatkowa opłata, która nie jest wliczona w kurs wymiany i jest pobierana od kwoty, którą klient przelewa do punktu wymiany. Podana jest w walucie from.
Przykład: <fromfee>2.15</fromfee> Możliwe jest również użycie znaku % do wskazania opłaty procentowej;
<tofee> – to dodatkowa opłata, która nie jest wliczona w kurs wymiany i pobierana jest od kwoty, którą kantor przekazuje klientowi. Jest wskazany w walucie to.
Przykład: <tofee>0.01508</tofee> Możliwe jest również użycie znaku % do wskazania opłaty procentowej;
<minfee> – to opłata minimalna, która jest naliczana za różnicę pomiędzy podaną kwotą a równowartością otrzymanej waluty w stosunku do średniego kursu wymiany. Podana jest wartość bezwzględna w walucie początkowej. Wartość procentowa nie jest dostępna dla tego typu prowizji.
Przykład: <minfee>5</minfee> Uwaga, miej na uwadze, że prowizja minfee nie ma nic wspólnego z dodatkowymi prowizjami fromfee i tofee, minimalna prowizja za daną lub otrzymaną prowizję nie jest aktualnie brana pod uwagę przez nasz system, uniknąć takiego tworzenia kursu. Zobacz przykłady użycia.
Uwaga: dodatkowa prowizja minfee ma wady, planowane jest usunięcie tego typu prowizji w najbliższej przyszłości.
<delay> – aby ustawić etykietę opóźnienia w centrali. Wskazany jest czas w minutach, o jaki nastąpi opóźnienie wymiany;
<param> – ten element służy do wskazania dodatkowych tagów.
Opłat stałych systemów płatności nie należy określać w pliku eksportu kursu. Nasz monitoring uwzględnia je niezależnie.
<?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>