Exchange rates:
12017
Exchangers:
161/163
Updated:
5 seconds ago

Exported rates file format

This page contains the description of the standard for generating exported rates file supported by the BestChange.com exchanger monitor. It is based on the XML format with the abbreviated currency names from Estandards.

  • The export file is generated in the XML format;
  • Every entry starts on a new line. A new line is started by the \n character;
  • A full stop is used as a decimal point for numerical values;
  • The root element is <rates>;
  • Every exchange direction is described in the <item> element;
  • Main elements for describing exchange rates and currency reserves:
    • <from> – source currency code. Electronic currency codes are listed below;
    • <to> – destination currency code. Electronic currency codes are listed below;
    • <in> – how much "from" currency the customer has to give;
    • <out> – how much "to" currency the customer will get;
    • <amount> – the "to" currency reserve in the exchanger.
  • Additional data for better integration with the BestChange.com monitor (it is required to specify it in the exported file if your exchanger takes minimal or additional commission fees or if it has non-automatic exchange directions):
    • <minfee> – the minimal commission fee the exchanger takes in the current exchange direction.
      Example: <minfee>5 USD</minfee>
      Possible national currency codes are listed below;
    • <fromfee> – the additional commission fee that is not included in the exchange rate and is taken from the sum the user transfers to the exchanger.
      Example: <fromfee>2.15 EUR</fromfee>
      Possible national currency codes are listed below. It is also possible to use the % character instead of the national currency code in order to specify the additional commission fee in percentage terms;
    • <tofee> – the additional commission fee that is not included in the exchange rate and is taken from the sum the exchanger transfers to the user.
      Example: <tofee>2 EUR</tofee>
      Possible national currency codes are listed below. It is also possible to use the % character instead of the national currency code in order to specify the additional commission fee in percentage terms;
    • <param> – this tag is used to specify additional properties, such as:
      • manual – the property must be specified for all non-automatic, non-instant exchange directions (for manual, operator-controlled, etc.);
      • juridical – this property means that the exchanger transfers money to the user bank account from a juridical account (for bank transfers);
      • verifying – this property means that the exchanger will require ID documents from their client in order to perform the exchange operation;
      • floating – floating rate, which is not fixed in the order. At the same time, the amount of exchange can change at the moment of sending funds to the client.
      If there are several attributes, they are separated with a comma.
      Example: <param>manual, floating</param>

Codes of electronic currencies

Currency codeDescription
PMUSDPerfect Money USD
PMEURPerfect Money EUR
PMBTCPerfect Money BTC
PMVUSDPM e-Voucher USD
PPUSDPayPal USD
PPEURPayPal EUR
PPGBPPayPal GBP
PPRUBPayPal RUB
BTCBitcoin
BCHBitcoin Cash
ETHEthereum
ETCEthereum Classic
LTCLitecoin
XRPRipple
XMRMonero
DOGEDogecoin
NMCNamecoin
PPCPeercoin
DASHDash
ZECZcash
USDTTether
XEMNEM
REPAugur
BTCEUSDBTC-e USD
BTCEEURBTC-e EUR
BTCERUBBTC-e RUB
BTCEBTCBTC-e BTC
EXMUSDExmo USD
EXMEURExmo EUR
EXMRUBExmo RUB
EXMUAHExmo UAH
CRPCUSDCryptocheck
ECNEXUSDeCoin
LVCNUSDLiveCoin
TRDUSDCryptoexchange USD
TRDEURCryptoexchange EUR
SKLUSDSkrill USD
SKLEURSkrill EUR
PAUSDPayza USD
PAEURPayza EUR
WMZWebMoney WMZ
WMEWebMoney WME
WMGWebMoney WMG
WMXWebMoney WMX
WMRWebMoney WMR
WMUWebMoney WMU
WMBWebMoney WMB
WMKWebMoney WMK
PMRUSDPaymer USD
PMREURPaymer EUR
PMRRUBPaymer RUB
PMRUAHPaymer UAH
PRUSDPayeer USD
PREURPayeer EUR
PRRUBPayeer RUB
PAXUMUSDPaxum USD
PAXUMEURPaxum EUR
NTLRUSDNeteller USD
NTLREURNeteller EUR
OKUSDOKPay USD
OKEUROKPay EUR
OKRUBOKPay RUB
ADVCUSDAdvanced Cash USD
ADVCEURAdvanced Cash EUR
ADVCRUBAdvanced Cash RUB
ADVCUAHAdvanced Cash UAH
MPLUSDMoneyPolo USD
MPLEURMoneyPolo EUR
PSRUSDPaySera
EPAYUSDEpay
ALPCNYAlipay
EPMUSDePayments
PSCEURPaySafeCard
CPTSUSDCapitalist
EPSUSDEpese
STPUSDSolidTrust Pay
WOUSDW1 USD
WOUAHW1 UAH
NIXUSDNixMoney USD
NIXEURNixMoney EUR
YAMRUBYandex.Money
ZPRUBZ-Payment
QWUSDQIWI USD
QWEURQIWI EUR
QWRUBQIWI RUB
QWKZTQIWI KZT
LQUSDLiqPay
EKZTE-kzt
IDAMDIdram
MWRUBMobile Wallet
CARDUSDVisa/MasterCard USD
CARDEURVisa/MasterCard EUR
CARDRUBVisa/MasterCard RUB
CARDUAHVisa/MasterCard UAH
CARDBYNVisa/MasterCard BYN
CARDKZTVisa/MasterCard KZT
WIREUSDWire USD
WIREEURWire EUR
WIREGBPWire GBP
WIRERUBWire RUB
WIREUAHWire UAH
WIREKZTWire KZT
WIRECNYWire CNY
WIRETHBWire THB
UPCNYUnionPay
SBERRUBSberbank
TBRUBVTB24
ACRUBAlfa-Bank
ACCUSDAlfa cash-in USD
ACCRUBAlfa cash-in RUB
RUSSTRUBRussian Standart
AVBRUBAvangard
TCSBRUBTinkoff
PSBRUBPromsvyazbank
GPBRUBGazprombank
KUKRUBKukuruza
RFBRUBRaiffeisen
RNKBRUBRNCB
P24USDPrivat 24 USD
P24UAHPrivat 24 UAH
RFBUAHRaiffeisen UAH
OSDBUAHOschadbank
PMBBUAHPUMB
BLRBBYNBelarusbank
KKBKZTKazkombank
HLKBKZTHalykBank
SBERKZTSberbank KZT
FRTBKZTForteBank
ATNBKZTAstana Bank
STLMRUBSP or LLC account
WUUSDWestern Union USD
WUEURWestern Union EUR
MGUSDMoneyGram USD
MGEURMoneyGram EUR
RMTFUSDRia USD
RMTFEURRia EUR
CNTUSDContact USD
USTMUSDUniStream
CNTRUBContact RUB
GCMTUSDGolden Crown USD
GCMTRUBGolden Crown RUB
CASHUSDCash USD
CASHEURCash EUR
CASHRUBCash RUB
CASHUAHCash UAH
CASHKZTCash KZT

Codes of national currencies

Currency codeDescription
AMDArmenian dram
BCHBitcoin Cash
BTCBitcoin
BYNBelarusian Ruble
CNYYuan
DSHDash
ETCEthereum Classic
ETHEthereum
EUREuro
GAU1 gram of gold
GBPPound sterling
KZTKazakhstani tenge
LTCLitecoin
NMCNamecoin
PPCPeercoin
REPAugur
RUBRussian Ruble
THBThai baht
UAHHryvnia
USDUS Dollar
UZSUzbekistan Sum
WMXWMX (0.001 BTC)
XDGDogecoin
XEMNEM
XMRMonero
XRPRipple
ZECZcash

Codes of cities

City codeDescription
ANTRAntratsyt, Ukraine
ASTNAstana, Kazakhstan
BRNBryansk, Russia
CHEBCheboksary, Russia
CHELChelyabinsk, Russia
DNPRDnipropetrovsk, Ukraine
DNTDonetsk, Ukraine
EKIBEkibastuz, Kazakhstan
HMLNHmelnitskij, Ukraine
IRKIrkutsk, Russia
IZHVIzhevsk, Russia
KZNKazan, Russia
KEMKemerovo, Russia
HRKKharkov, Ukraine
KIEVKiev, Ukraine
KSTKostanay, Kazakhstan
KRSKKrasnoyarsk, Russia
KRMNKremenchuk, Ukraine
KRVRKrivoy Rog, Ukraine
KURSKKursk, Russia
LVOVLvov, Ukraine
MRPLMariupol, Ukraine
MINSKMinsk, Belarus
MSKMoscow, Russia
MYKLMykolaiv, Russia
NABCHNaberezhnye Chelny, Russia
NNOVNizhny Novgorod, Russia
NSKNovosibirsk, Russia
ODSOdessa, Ukraine
OMSKOmsk, Russia
PERMPerm, Russia
PTGRPyatigorsk, Russia
RIGARiga, Latvia
RSNDRostov-on-Don, Russia
SPBSaint Petersburg, Russia
SMRSamara, Russia
SIMFSimferopol, Russia
SOCHISochi, Russia
STAVStavropol, Russia
TGNTaganrog, Russia
TULATula, Russia
VLGDVolgograd, Russia
EKBYekaterinburg, Russia
ERVNYerevan, Armenia
ZAPZaporizhia, Ukraine

Example

<rates>

<item>
<from>WMZ</from>
<to>WMR</to>
<in>1</in>
<out>30.593562</out>
<amount>572962.42</amount>
</item>

<item>
<from>OKUSD</from>
<to>PMUSD</to>
<in>1</in>
<out>0.978</out>
<amount>2921.42</amount>
<minfee>7 USD</minfee>
<param>manual</param>
</item>

<item>
<from>WMR</from>
<to>CARDRUB</to>
<in>1</in>
<out>0.980</out>
<amount>67341.10</amount>
<minfee>130 RUB</minfee>
<tofee>1 %</tofee>
<param>manual, juridical</param>
</item>

<item>
<from>PMUSD</from>
<to>CASHUSD</to>
<in>1</in>
<out>0.9705</out>
<amount>3901.90</amount>
<minfee>5 USD</minfee>
<city>MSK</city>
</item>

</rates>

Example link to exported rates file


FAQ for Export rates file

Our export file is updated every minute. Is this fast enough?
No, it is not enough. Our monitoring requests exchange rates every 5-8 seconds, therefore, to increase precision of the data transferred, it is required that your exchange office provides export file which would contain information representing exchange rates equivalent to those on your web page.
One of the following options of export implementation can be used:
  • A script that generates new export data on every request;
  • Static export file being generated every time any change of rates/reserves/commissions occurs on your exchange office web page.
Our exchanger has several levels of rates depending on the sum to be exchanged. How should we specify it in our export file?
Our monitoring does not support multilevel rates. In this case, exchange rates with maximum percentage available should be reported.
Our exchanger has limits with regard to the maximum sum to be exchanged at a time. How should we specify it in our export file?
To implement this, you should make correction of reserves respective to set limits in the exchange directions where the limits are applicable.
Example: Perfect Money USD PayPal EUR direction is limited to accept maximum of 1000 USD Perfect Money. In this case, you should set 1000 USD reserve in target currency, this is to convert 1000 USD in EUR.
If a limit equal to 0 is set, such directions should not be exported, or their reserve should also be 0.
Is it possible to set up our display in your list so that we are displayed from Monday to Saturday 9:00 to 19:00, but were not displayed on Sunday?
There are 2 ways to do it:
  1. Set up the export rates generation script so that the export file is cleared automatically (or rates or reserves are set to 0) on the days when you are not working;
  2. Enable or disable the listing of your exchange office manually using corresponding link in your bestchange.org account.

If you have any questions, you can ask them by contacting us with the help of the methods specified on the contacts page.