Exchange rates:
53189
Exchangers:
217
Updated:
for 7 seconds

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;
  • Elements for describing each direction of exchange:
    • <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;
    • <minfee> – is a minimal commission which is calculated for the difference between the currency the user gives and the equivalent of the currency the user gets in the reference with the average exchange rate. You must specify it with the code of the national currency.
      Example: <minfee>5 USD</minfee>
      Please take into account that minfee has no reference with the commissions fromfee and tofee, the minimal commission for the commission the customer gives and the customer gets is not calculated in our system, please avoid such forming of the rate. See usage examples.
      Example #1. Minimal commission is larger than the exchanger's margin
      Exchange rate of 1 EUR is 1.1 USD, and official rate is 1.15 USD. The margin is 0,05. When exchanging 10 EUR, the margin of the exchanger is 0,5. But minimal commission of 1 USD is more than the margin of 0,5, that's why 0,5 is substituted by 1 USD and the remained is being extracted from the amount received: 11 - (1 - 0.5) = 9.5.
      Example #2. Minimal commission is smaller than the exchanger's margin
      Exchange rate of 1 EUR is 1.1 USD, and official rate is 1.15 USD. The margin is 0,05. When exchanging 100 EUR, the margin of the exchanger is 5 USD. The minimal commissions is smaller than that, thats why this parameter is not calculated in this equation: 110 - 5 = 105.
    • <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. You must specify it with the code of the national currency.
      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. You must specify it with the code of the national currency.
      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;
    • <minamount> – the minimal amount of currency for exchanging that the exchanger can take from a client. You must specify it with the code of the national currency.
      Example: <minamount>4.1 USD</minamount>
      If you have several limits on minimal amount, for example, a separate amount for receiving and for paying, you must specify the maximal value of such limitation in the field of minamount converted in the from currency. If it is not possible to select the maximal value from several minimal amounts, you must specify additional fields minamount with a separate minimal amount in each one;
    • <maxamount> – the maximal amount of currency the exchanger can take from a client for a one-time transaction. You must specify it with the code of the national currency.
      Example: <maxamount>5000 USD</maxamount>
      If you have several limits on maximal amount, for example a separate amount for receiving and for paying, you must specify the minimal value of such limitation in the field of maxiamount converted in the from currency. If it is not possible to select the minimal value from several maximal amounts, you must specify additional fields maxamount with a separate maximal amount in each one;
    • <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 can require ID documents from their client in order to perform the exchange operation;
      • cardverify – this property means that the exchanger can require verification of a bank card;
      • 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;
      • otherin – receiving customer's funds is being done on a side payment system, not on the one specified in the field from;
      • otherout – payment of fund to the client is being done from the side payment system, not the one specified in the field to.
      If there are several attributes, they are separated with a comma.
      Example: <param>manual, floating</param>
    • <city> – to specify cities where the exchange exchanges e-currencies into cash or vice versa. It makes sense to specify this field only for cash operations. The export file can have direction with various specified cities.
      Example: <city>ANTR</city>
  • You do not need to specify constant commissions of payment systems in your rates export file. Our monitoring counts them on its own.

Codes of electronic currencies

Currency codeDescription
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)
BTTBitTorrent (BTT)
PMUSDPerfect Money USD
PMEURPerfect Money EUR
PMBTCPerfect Money BTC
PMVUSDPM e-Voucher USD
PPUSDPayPal USD
PPEURPayPal EUR
PPGBPPayPal GBP
PPRUBPayPal RUB
ADVCUSDAdvanced Cash USD
ADVCEURAdvanced Cash EUR
ADVCRUBAdvanced Cash RUB
ADVCUAHAdvanced Cash UAH
SKLUSDSkrill USD
SKLEURSkrill EUR
SKLGBPSkrill GBP
WMZWebMoney WMZ
WMEWebMoney WME
WMGWebMoney WMG
WMXWebMoney WMX
WMRWebMoney WMR
WMUWebMoney WMU
WMBWebMoney WMB
WMKWebMoney WMK
PMRUSDPaymer USD
PMRRUBPaymer RUB
PRUSDPayeer USD
PREURPayeer EUR
PRRUBPayeer RUB
PAXUMUSDPaxum
NTLRUSDNeteller USD
NTLREURNeteller EUR
PSRUSDPaySera
EPAYUSDEpay USD
EPAYEUREpay EUR
ALPCNYAlipay
WCTCNYWeChat
PSCEURPaySafeCard
CPTSUSDCapitalist USD
CPTSRUBCapitalist RUB
EPSUSDEpese
STPUSDSolidTrust Pay
WOUSDW1 USD
WORUBW1 RUB
EPMUSDePayments USD
EPMEURePayments EUR
NIXUSDNixMoney USD
NIXEURNixMoney EUR
GMUAHGlobalMoney
YAMRUBYandex.Money
QWUSDQIWI USD
QWEURQIWI EUR
QWRUBQIWI RUB
QWKZTQIWI KZT
LQUSDLiqPay
EKZTE-kzt
IDAMDIdram
MWRUBMobile Wallet RUB
MWUAHMobile Wallet UAH
TRDUSDCryptoexchange USD
TRDEURCryptoexchange EUR
EXMUSDExmo USD
EXMEURExmo EUR
EXMBTCExmo BTC
EXMRUBExmo RUB
EXMUAHExmo UAH
LVCNUSDLiveCoin USD
LVCNRUBLiveCoin RUB
ECNEXUSDeCoin
CCXUSDC-Cex
KUNAUAHKuna
CARDUSDVisa/MasterCard USD
CARDEURVisa/MasterCard EUR
CARDGBPVisa/MasterCard GBP
CARDCNYVisa/MasterCard CNY
CARDJPYVisa/MasterCard JPY
CARDRUBVisa/MasterCard RUB
CARDUAHVisa/MasterCard UAH
CARDBYNVisa/MasterCard BYN
CARDKZTVisa/MasterCard KZT
CARDAMDVisa/MasterCard AMD
AMEXUSDAmEx Card
UPCNYUnionPay Card
MIRCRUBMir Card
UZCUZSUZCARD Card
WIREUSDWire USD
WIREEURWire EUR
WIREGBPWire GBP
WIRERUBWire RUB
WIREUAHWire UAH
WIREKZTWire KZT
WIRECNYWire CNY
WIREPLNWire PLN
WIRETHBWire THB
WIREINRWire INR
WIRENGNWire NGN
SEPAEURSepa EUR
ERIPBYNERIP Raschet
SBERRUBSberbank
TBRUBVTB24
ACRUBAlfa-Bank
ACCUSDAlfa cash-in USD
ACCRUBAlfa cash-in RUB
RUSSTRUBRussian Standart
AVBRUBAvangard
TCSBRUBTinkoff
TCSBCRUBTCS cash-in
PSBRUBPromsvyazbank
GPBRUBGazprombank
KUKRUBKukuruza
RFBRUBRaiffeisen
RNKBRUBRNCB
BINBRUBBinbank
RKTBRUBRocketbank
P24USDPrivat 24 USD
P24UAHPrivat 24 UAH
RFBUAHRaiffeisen UAH
OSDBUAHOschadbank
USBUAHUkrSibbank
PMBBUAHPUMB
MONOBUAHMonobank
BLRBBYNBelarusbank
KKBKZTKazkombank
HLKBKZTHalykBank
SBERKZTSberbank KZT
FRTBKZTForteBank
KSPBKZTKaspi Bank
STLMRUBSP or LLC account
WUUSDWU USD
WUEURWU EUR
MGUSDMoneyGram USD
MGEURMoneyGram EUR
RMTFUSDRia USD
RMTFEURRia EUR
CNTUSDContact USD
USTMUSDUniStream USD
USTMRUBUniStream RUB
CNTRUBContact RUB
GCMTUSDGolden Crown USD
GCMTRUBGolden Crown RUB
CASHUSDCash USD
CASHEURCash EUR
CASHRUBCash RUB
CASHUAHCash UAH
CASHBYNCash BYN
CASHKZTCash KZT

Codes of national currencies

Currency codeDescription
ADACardano
AMDArmenian dram
BCHBitcoin BCH
BCNBytecoin
BNBBinance Coin
BSVBitcoin SV
BTCBitcoin
BTGBitcoin Gold
BTTBitTorrent
BYNBelarusian Ruble
CNYYuan
DSHDash
EOSEOS
ETCEthereum Classic
ETHEthereum
EUREuro
GAU1 gram of gold
GBPPound sterling
ICXICON
INRIndian rupee
IOTIOTA
JPYJapanese yen
KMDKomodo
KZTKazakhstani tenge
LSKLisk
LTCLitecoin
NEONEO
NGNNigerian naira
OMGOmiseGO
PLNPolish zloty
PPCPeercoin
REPAugur
RUBRussian Ruble
THBThai baht
TRXTRON
UAHHryvnia
USDUS Dollar
UZSUzbekistan Sum
WAVWAVES
WMXWMX (0.001 BTC)
XDGDogecoin
XEMNEM
XLMStellar
XMRMonero
XRPRipple
XVGVerge
ZECZcash
ZRX0x

Codes of cities

City codeDescription
ANTRAntratsyt, Ukraine
ASTNAstana, Kazakhstan
BEIJBeijing, China
BRNBryansk, Russia
CHEBCheboksary, Russia
CHELChelyabinsk, Russia
CHERKCherkasy, Ukraine
CHERNChernivtsi, Ukraine
DNPRDnipro, Ukraine
DNTDonetsk, Ukraine
DUBAIDubai, United Arab Emirates
EKIBEkibastuz, Kazakhstan
GOMELGomel, Belarus
GUANGuangzhou, China
HMLNHmelnitskij, Ukraine
IRKIrkutsk, Russia
STAMIstanbul, Turkey
IVFRIvano-Frankivsk, Ukraine
IZHVIzhevsk, Russia
KZNKazan, Russia
KEMKemerovo, Russia
HRKKharkov, Ukraine
KHERSKherson, Ukraine
KIEVKiev, Ukraine
KISHKishinev, Moldova
KSTKostanay, Kazakhstan
KRAMKramatorsk, Ukraine
KRASNKrasnodar, Russia
KRSKKrasnoyarsk, Russia
KRMNKremenchuk, Ukraine
KRVRKrivoy Rog, Ukraine
KROPKropyvnytskyi, Ukraine
KURSKKursk, Russia
LUTSKLutsk, Ukraine
LVOVLvov, Ukraine
MANAMManama, Bahrain
MRPLMariupol, Ukraine
MELITMelitopol, Ukraine
MINSKMinsk, Belarus
MSKMoscow, Russia
MYKLMykolaiv, Ukraine
NABCHNaberezhnye Chelny, Russia
NNOVNizhny Novgorod, Russia
NVKZNNovokuznetsk, Russia
NSKNovosibirsk, Russia
ODSOdessa, Ukraine
OMSKOmsk, Russia
PERMPerm, Russia
POLTPoltava, Ukraine
PTGRPyatigorsk, Russia
RIGARiga, Latvia
RIVNERivne, Ukraine
RSNDRostov-on-Don, Russia
SPBSaint Petersburg, Russia
SMRSamara, Russia
SIMFSimferopol, Russia
SOCHISochi, Russia
STAVStavropol, Russia
SUMYSumy, Ukraine
TGNTaganrog, Russia
TBILTbilisi, Georgia
TEHRTehran, Iran
TERNOTernopil, Ukraine
TULATula, Russia
UZHHUzhhorod, Ukraine
VINNVinnytsia, Ukraine
VLGDVolgograd, Russia
EKBYekaterinburg, Russia
ERVNYerevan, Armenia
ZAPZaporizhia, Ukraine
ZHYTOZhytomyr, Ukraine

Example

<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>

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.
If you have DDoS protection on your site, add the IP address of our robot (85.119.149.10) to the whitelist to prevent access to your exported rates file from being blocked.
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.