Всего курсов:
69202
Обменников:
430
Обновление:
20:19:58

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

На данной странице приведено описание стандарта для формирования экспортного файла курсов, поддерживаемого мониторингом обменных пунктов BestChange.ru. Пример содержимого подобного файла можно увидеть ниже.

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

  • Экспортный файл формируется в XML-формате;
  • Каждая запись идет с новой строки. Перенос осуществляется символом \n;
  • Для числовых значений разделителем целой части является точка;
  • Корневой элемент – <rates>;
  • Каждое направление обмена описывается в элементе <item>;
  • Элементы для описания каждого направления обмена:
    • <from> – код валюты, которую обменный пункт принимает от клиента. Коды электронных валют приведены в списке ниже;
    • <to> – код валюты, которую обменный пункт отправляет клиенту. Коды электронных валют приведены в списке ниже;
    • <in> – сколько валюты from должен отдать клиент;
    • <out> – сколько валюты to получит клиент;
    • <amount> – размер резерва валюты to в обменнике;
    • <minfee> – минимальная комиссия, которая рассчитывается для разницы между отдаваемой суммой и эквивалентом получаемой валюты относительно среднего биржевого курса. Указывается с кодом национальной валюты.
      Пример: <minfee>5 USD</minfee>
      Пожалуйста, имейте в виду, что к дополнительным комиссиям fromfee и tofee комиссия minfee не имеет отношения, минимальная комиссия для отдаваемой или получаемой комиссии на данный момент никак не учитывается нашей системой, избегайте подобного формирования курса. Смотрите примеры использования.
      Пример №1. Минимальная комиссия больше маржи обменного пункта
      Курс обмена 1 доллара – 66 рублей, а официальный курс 68 рублей. Маржа составляет 2 рубля. При обмене 10 долларов получается, что 20 рублей – маржа обменника. Но минимальная комиссия 100 рублей больше маржи в 20 рублей, поэтому 20 заменяется на 100 и происходит вычитание остатка из получаемой суммы: 660 - (100 - 20) = 580.
      Пример №2. Минимальная комиссия меньше маржи обменного пункта
      Курс обмена 1 доллара – 66 рублей, а официальный курс 68 рублей. Маржа составляет 2 рубля. При обмене 100 долларов получается, что 200 рублей – маржа обменника. Минимальная комиссия меньше этого значения, поэтому этот параметр в данном расчете не учитывается: 6600 - 200 = 6400.
    • <fromfee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую клиент переводит в обменный пункт. Указывается с кодом национальной валюты.
      Пример: <fromfee>2.15 EUR</fromfee>
      Вместо кода нац. валюты возможно также использование знака % для обозначения процентной дополнительной комиссии;
    • <tofee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую обменный пункт переводит клиенту. Указывается с кодом национальной валюты.
      Пример: <tofee>30 RUB</tofee>
      Вместо кода нац. валюты возможно также использование знака % для обозначения процентной дополнительной комиссии;
    • <minamount> – минимальная возможная к обмену сумма валюты, которую обменный пункт принимает от клиента. Указывается с кодом национальной валюты.
      Пример: <minamount>4.1 USD</minamount>
      Если ограничений по минимальной сумме несколько, например, отдельно на прием и на выплату, необходимо указывать в поле minamount максимальное значение такого ограничения, сконвертированное в валюту from. Если нет возможности выбрать максимальное значение из нескольких значений минимальных сумм, необходимо указать дополнительные поля minamount с отдельной минимальной суммой в каждом;
    • <maxamount> – максимальная возможная к разовому обмену сумма валюты, которую обменный пункт принимает от клиента. Указывается с кодом национальной валюты.
      Пример: <maxamount>5000 USD</maxamount>
      Если ограничений по максимальной сумме несколько, например, отдельно на прием и на выплату, необходимо указывать в поле maxamount минимальное значение такого ограничения, сконвертированное в валюту from. Если нет возможности выбрать минимальное значение из нескольких значений максимальных сумм, необходимо указать дополнительные поля maxamount с отдельной максимальной суммой в каждом;
    • <param> – данный элемент служит для указания дополнительных меток, таких как:
      • manual – метка должна указываться для направлений обмена, которые обрабатываются через оператора вручную, либо если обмен по направлению производится с задержками (не моментально);
      • juridical – обменный пункт производит переводы средств на банковский счет клиента со счета юридического лица или ИП. Указывается только для банковских направлений;
      • verifying – при проведении обмена обменный пункт может требовать от клиента документы, удостоверяющие его личность;
      • cardverify – при проведении обмена обменный пункт может требовать от клиента верифицировать банковскую карту;
      • floating – плавающий курс, который не фиксируется в заявке. При этом сумма обмена может измениться на момент отправки средств клиенту;
      • otherin – прием денежных средств от клиента производится на стороннюю платежную систему, а не на ту, что указана в поле from;
      • otherout – выплата денежных средств клиенту производится со сторонней платежной системы, а не с той, что указана в поле to.
      Если меток несколько, они указываются через запятую.
      Пример: <param>manual, floating</param>
    • <city> – для указания города, в котором обменный пункт производит ввод/вывод электронных денег на наличные. Это поле имеет смысл указывать только для направлений с наличными. Экспортный файл может содержать направления обменов с разными указанными городами.
      Пример: <city>MSK</city>
  • Постоянные комиссии платежных систем не должны указываться в экспортном файле курсов. Наш мониторинг учитывает их самостоятельно.

Коды электронных валют

Код валютыОписание
WMZWMZ
WMRWMR
WMEWME
WMUWMU
WMBWMB
WMKWMK
WMGWMG
WMXWMX
PMRUSDPaymer USD
PMRRUBPaymer RUB
YAMRUBЯндекс.Деньги
QWUSDQIWI USD
QWRUBQIWI RUB
QWEURQIWI EUR
QWKZTQIWI KZT
PMUSDPerfect Money USD
PMEURPerfect Money EUR
PMBTCPerfect Money BTC
PMVUSDPM e-Voucher USD
PPUSDPayPal USD
PPRUBPayPal RUB
PPEURPayPal EUR
PPGBPPayPal GBP
BTCBitcoin (BTC)
BCHBitcoin Cash (BCH)
BSVBitcoin SV (BSV)
BTGBitcoin Gold (BTG)
ETHEthereum (ETH)
ETCEther Classic (ETC)
LTCLitecoin (LTC)
XRPRipple (XRP)
XMRMonero (XMR)
DOGEDogecoin (DOGE)
PPCPeercoin (PPC)
DASHDash (DASH)
ZECZcash (ZEC)
USDTTether (USDT)
USDCUSD Coin (USDC)
TUSDTrueUSD (TUSD)
XEMNEM (XEM)
REPAugur (REP)
NEONEO (NEO)
EOSEOS (EOS)
IOTAIOTA (MIOTA)
LSKLisk (LSK)
ADACardano (ADA)
XLMStellar (XLM)
BCNBytecoin (BCN)
TRXTRON (TRX)
WAVESWaves (WAVES)
OMGOmiseGO (OMG)
XVGVerge (XVG)
ZRX0x (ZRX)
BNBBinance Coin (BNB)
ICXICON (ICX)
KMDKomodo (KMD)
EXMUSDExmo USD
EXMRUBExmo RUB
EXMEURExmo EUR
EXMUAHExmo UAH
EXMBTCExmo BTC
LVCNUSDLiveCoin USD
LVCNRUBLiveCoin RUB
ECNEXUSDeCoin
CCXUSDC-Cex
TRDUSDКриптобиржи USD
TRDEURКриптобиржи EUR
ADVCUSDAdvanced Cash USD
ADVCRUBAdvanced Cash RUB
ADVCEURAdvanced Cash EUR
ADVCUAHAdvanced Cash UAH
PRUSDPayeer USD
PRRUBPayeer RUB
PREURPayeer EUR
SKLUSDSkrill USD
SKLEURSkrill EUR
SKLGBPSkrill GBP
WOUSDW1 USD
WORUBW1 RUB
IDAMDIdram
PAXUMUSDPaxum
CPTSUSDCapitalist USD
CPTSRUBCapitalist RUB
EPSUSDEpese
NTLRUSDNeteller USD
NTLREURNeteller EUR
PSRUSDPaySera
PSCEURPaySafeCard
STPUSDSolidTrust Pay
EPMUSDePayments USD
EPMEURePayments EUR
NIXUSDNixMoney USD
NIXEURNixMoney EUR
GMUAHGlobalMoney
EPAYUSDEpay USD
EPAYEUREpay EUR
ALPCNYAlipay
WCTCNYWeChat
LQUSDLiqPay
EKZTE-kzt
MWRUBСчет телефона RUB
MWUAHСчет телефона UAH
SBERRUBСбербанк
ACRUBАльфа-Банк
ACCUSDАльфа cash-in USD
ACCRUBАльфа cash-in RUB
TCSBRUBТинькофф
TCSBCRUBТКС cash-in
TBRUBВТБ24
RUSSTRUBРусский Стандарт
AVBRUBАвангард
PSBRUBПромсвязьбанк
GPBRUBГазпромбанк
KUKRUBКукуруза
RFBRUBРайффайзен
RNKBRUBРНКБ
BINBRUBБинбанк
RKTBRUBРокетбанк
P24USDПриват 24 USD
P24UAHПриват 24 UAH
RFBUAHРайффайзен UAH
OSDBUAHОщадбанк
USBUAHУкрСиббанк
PMBBUAHПУМБ
MONOBUAHМонобанк
BLRBBYNБеларусбанк
KKBKZTКазкоммерцбанк
HLKBKZTHalykBank
SBERKZTСбербанк KZT
FRTBKZTForteBank
KSPBKZTKaspi Bank
CARDUSDVisa/MasterCard USD
CARDRUBVisa/MasterCard RUB
CARDEURVisa/MasterCard EUR
CARDUAHVisa/MasterCard UAH
CARDBYNVisa/MasterCard BYN
CARDKZTVisa/MasterCard KZT
CARDAMDVisa/MasterCard AMD
CARDGBPVisa/MasterCard GBP
CARDJPYVisa/MasterCard JPY
AMEXUSDКарта AmEx
MIRCRUBКарта Мир
UPCNYКарта UnionPay
UZCUZSКарта UZCARD
WIREUSDЛюбой банк USD
WIRERUBЛюбой банк RUB
WIREEURЛюбой банк EUR
WIREUAHЛюбой банк UAH
WIREKZTЛюбой банк KZT
WIREGBPЛюбой банк GBP
WIRECNYЛюбой банк CNY
WIRETHBЛюбой банк THB
WIREINRЛюбой банк INR
WIRENGNЛюбой банк NGN
SEPAEURSepa EUR
ERIPBYNЕРИП Расчет
STLMRUBСчет ИП или ООО
WUUSDWU USD
WUEURWU EUR
MGUSDMoneyGram USD
MGEURMoneyGram EUR
CNTUSDContact USD
CNTRUBContact RUB
GCMTUSDЗолотая Корона USD
GCMTRUBЗолотая Корона RUB
USTMUSDЮнистрим USD
USTMRUBЮнистрим RUB
RMTFUSDRia USD
RMTFEURRia EUR
CASHUSDНаличные USD
CASHRUBНаличные RUB
CASHEURНаличные EUR
CASHUAHНаличные UAH
CASHBYNНаличные BYN
CASHKZTНаличные KZT

Коды национальных валют

Код валютыОписание
ADACardano
AMDАрмянский драм
BCHBitcoin BCH
BCNBytecoin
BNBBinance Coin
BSVBitcoin SV
BTCBitcoin
BTGBitcoin Gold
BYNБелорусский рубль
CNYЮань
DSHDash
EOSEOS
ETCEthereum Classic
ETHEthereum
EURЕвро
GAU1 грамм золота
GBPФунт стерлингов
ICXICON
INRИндийская рупия
IOTIOTA
JPYЯпонская иена
KMDKomodo
KZTКазахстанский тенге
LSKLisk
LTCLitecoin
NEONEO
NGNНигерийская найра
OMGOmiseGO
PPCPeercoin
REPAugur
RUBРоссийский рубль
THBТайский бат
TRXTRON
UAHГривна
USDДоллар США
UZSУзбекский сум
WAVWAVES
WMXWMX (0.001 BTC)
XDGDogecoin
XEMNEM
XLMStellar
XMRMonero
XRPRipple
XVGVerge
ZECZcash
ZRX0x

Коды городов

Код городаОписание
ANTRАнтрацит, Украина
ASTNАстана, Казахстан
BRNБрянск, Россия
VINNВинница, Украина
VLGDВолгоград, Россия
GUANГуанчжоу, Китай
DNPRДнепр, Украина
DNTДонецк, Украина
DUBAIДубай, Объединенные Арабские Эмираты
EKBЕкатеринбург, Россия
ERVNЕреван, Армения
ZHYTOЖитомир, Украина
ZAPЗапорожье, Украина
IVFRИвано-Франковск, Украина
IZHVИжевск, Россия
IRKИркутск, Россия
KZNКазань, Россия
KEMКемерово, Россия
KIEVКиев, Украина
KISHКишинев, Молдова
KSTКостанай, Казахстан
KRAMКраматорск, Украина
KRASNКраснодар, Россия
KRSKКрасноярск, Россия
KRMNКременчуг, Украина
KRVRКривой Рог, Украина
KROPКропивницкий, Украина
KURSKКурск, Россия
LUTSKЛуцк, Украина
LVOVЛьвов, Украина
MANAMМанама, Бахрейн
MRPLМариуполь, Украина
MELITМелитополь, Украина
MINSKМинск, Беларусь
MSKМосква, Россия
NABCHНабережные Челны, Россия
NNOVНижний Новгород, Россия
MYKLНиколаев, Украина
NVKZNНовокузнецк, Россия
NSKНовосибирск, Россия
ODSОдесса, Украина
OMSKОмск, Россия
BEIJПекин, Китай
PERMПермь, Россия
POLTПолтава, Украина
PTGRПятигорск, Россия
RIGAРига, Латвия
RIVNEРовно, Украина
RSNDРостов-на-Дону, Россия
SMRСамара, Россия
SPBСанкт-Петербург, Россия
SIMFСимферополь, Россия
SOCHIСочи, Россия
STAVСтаврополь, Россия
STAMСтамбул, Турция
SUMYСумы, Украина
TGNТаганрог, Россия
TBILТбилиси, Грузия
TEHRТегеран, Иран
TERNOТернополь, Украина
TULAТула, Россия
UZHHУжгород, Украина
HRKХарьков, Украина
KHERSХерсон, Украина
HMLNХмельницкий, Украина
CHEBЧебоксары, Россия
CHELЧелябинск, Россия
CHERKЧеркассы, Украина
CHERNЧерновцы, Украина
EKIBЭкибастуз, Казахстан

Пример

<rates>

<item>
<from>WMZ</from>
<to>WMX</to>
<in>1</in>
<out>30.593562</out>
<amount>572962.42</amount>
<minamount>3 USD</minamount>
<maxamount>1000 USD</maxamount>
</item>

<item>
<from>ADVCUSD</from>
<to>PMUSD</to>
<in>1</in>
<out>0.978</out>
<amount>2921.42</amount>
<minamount>2 USD</minamount>
<maxamount>2000 USD</maxamount>
<minfee>7 USD</minfee>
<param>manual</param>
</item>

<item>
<from>BTC</from>
<to>ETH</to>
<in>1</in>
<out>24.90782568</out>
<amount>673.10</amount>
<minamount>2 USD</minamount>
<maxamount>0.42341216 BTC</maxamount>
<tofee>1 %</tofee>
<param>manual, juridical</param>
</item>

<item>
<from>BTC</from>
<to>CASHUSD</to>
<in>1</in>
<out>4342.352344</out>
<amount>31.90343295</amount>
<minamount>1.5 USD</minamount>
<maxamount>1000 USD</maxamount>
<minfee>5 USD</minfee>
<city>ANTR</city>
</item>

</rates>

Ссылка на примерный экспортный файл курсов


FAQ по экспортным курсам

Наш экспортный файл обновляется раз в минуту через Cron. Достаточно ли такой периодичности?
Нет, этого недостаточно. Cron в данном случае не годится. Наш мониторинг запрашивает файлы курсов каждые 5-8 секунд, поэтому для повышения точности передаваемых данных необходимо, чтобы обменный пункт имел экспортный файл, который в любой момент времени будет содержать информацию, соответствующую информации на сайте обменного пункта.
Подойдет один из следующих вариантов реализации экспорта:
  • Скрипт, который при каждом его запросе генерирует новые экспортные данные;
  • Статичный экспортный файл, который будет программно пересоздан каждый раз, когда какое-либо изменение курсов/резервов/комиссий произойдет на сайте обменного пункта.
В случае наличия на вашем сайте защиты от DDoS, добавьте IP-адрес нашего робота (85.119.149.10) в белый список для предотвращения блокировки доступа к вашему файлу курсов.
Наш обменный пункт имеет ступенчатые курсы обмена, которые изменяются в зависимости от суммы обмена. Как указать это в экспорте?
Мониторинг не поддерживает ступенчатые курсы. В данном случае, в экспорт должны передаваться курсы обмена с максимально возможным процентом.
Наш обменный пункт имеет лимиты на максимальную дневную сумму обмена. Как указать это в экспорте?
Для этого нужно, в зависимости от размера установленного лимита, сделать автоматическую коррекцию резервов в тех направлениях, где есть лимиты.
Например: по направлению QIWI WMZ установлен лимит на прием QIWI в 1000 RUB максимум – в таком случае нужно для этого направления установить резерв 1000 RUB в валюте получения, т.е. перевести 1000 RUB в USD.
Если установлен лимит равный нулю, то такие направления не должны передаваться в экспорт, либо резерв этих направлений также должен быть нулевым.
Можно ли сделать, чтобы мы отображались в листинге с понедельника по субботу включительно, с 9:00 до 19:00, а в воскресенье чтобы не отображались?
Это можно сделать 2-я способами:
  1. Настроить скрипт генерации экспортных курсов так, чтобы файл курсов автоматически очищался (либо в нем обнулялись курсы или резервы) в то время, когда вы не работаете;
  2. Вручную каждый раз включать и выключать присутствие обменника в мониторинге при помощи ссылки Включить/Выключить в вашем аккаунте на bestchange.org

Если у вас возникли вопросы, вы можете задать их, связавшись с нами одним из способов, указанных на странице контактов.