Instructions for creating an export file of exchange rates

This page contains information on the requirements for the format of the exported exchange rate file. Attention to these rules is necessary for the accurate display of exchange rates in the Kursoff exchanger monitoring. To add your exchanger and other related information, you must provide a link to the export file hosted on your website in the integration request.

Basic instructions

1. XML format is required for exporting course files.
2. Each entry must be on a new line. The \n character is used for hyphenation.
3. Use a period to separate fractions in numerical values.
4. The root element is <rates>.
5. Each exchange rate must be described in the <item> element.
6. Required elements for describing the exchange rate inside the item element:
- <from>: the code of the currency that the exchanger accepts from the client. Currency codes are available at the bottom of the page.
- <to>: the code of the currency that the exchanger sends to the client.
- <in>: an indication of the exchange rate, how much currency the client should give.
- <out>: specifies the exchange rate, and how much currency the client will receive.
- <amount>: the amount of currency reserved at the exchange office (the maximum amount that a client can receive).
- <minamount>: the minimum amount of currency that the exchange office accepts from the client. It is specified in the currency from.

Example
<minamount>4.1</minamount>. If there are several restrictions on the minimum amount, you must specify the maximum value of such a restriction in the minamount field. If it is not possible to choose the maximum value from several minimum amounts, you must specify additional minamount fields with a separate minimum amount in each.

7. Additional elements to describe the exchange rate inside the item element:
- <fromfee>: an additional fee that is not included in the exchange rate and is deducted from the amount that the client transfers to the exchange office. It is specified in the from currency.

Example: <fromfee>2.15</fromfee>. You can also use % to indicate the fee as a percentage.

These instructions will help you to structure your exported exchange rate file according to the requirements of the XML format.

Electronic currency codes

Currency code

Description

ACCUSDАльфа cash-in (USD)
ACEURAlfa Bank (EUR)
ACKZTAlfa Bank (KZT)
ACUAHАльфа Банк (UAH)
ACUSDAlfa Bank (USD)
ADVCEURAdvanced Cash (EUR)
ADVCUSDAdvanced Cash (USD)
ATNBKZTAstana Bank (KZT)
BCBCNYBank of China (CNY)
BCBUSDBank of China (USD)
BCHBitcoin Cash (BCH)
BTCBitcoin (BTC)
CARDAMDVisa/MasterCard (AMD)
CARDEURVisa/MasterCard (EUR)
CARDGBPVisa/MasterCard (GBP)
CARDKZTVisa/MasterCard (KZT)
CARDUAHVisa/MasterCard (UAH)
CARDUSDVisa/MasterCard (USD)
CASHAMDГотівка (AMD)
CASHEURГотівка (EUR)
CASHGBPГотівка (GBP)
CASHKZTГотівка (KZT)
CASHUAHГотівка (UAH)
CASHUSDГотівка (USD)
CCBCNYChina Construction Bank (CNY)
CMBCNYChina Merchants Bank (CNY)
CPTSUSDCapitalist (USD)
CUPCNYChinaUnionPay (CNY)
DASHDash (DASH)
DOGEDogecoin (DOGE)
ETCEthereum Classic (ETC)
ETHEthereum (ETH)
EURBKZTEurasian Bank (KZT)
EURBUSDEurasian Bank (USD)
EXMEURExmo (EUR)
EXMUSDExmo (USD)
FRTBKZTForteBank (KZT)
FRTBUSDForteBank (USD)
HCSBKZTZhilstroysberbank (KZT)
HLKBKZTHalykBank (KZT)
HLKBUSDHalyk Bank (USD)
ICBCCNYIndustrial and Commercial Bank of China (CNY)
KKBKZTКазкоммерцбанк (KZT)
KKBUSDKazkombank (USD)
LTCLitecoin (LTC)
MGEURMoneygram (EUR)
MGUSDMoneygram (USD)
NTLREURNeteller (EUR)
NTLRUSDNeteller (USD)
OSDBUAHОщад банк (UAH)
OTPBUAHОТП Банк (UAH)
P24EURPrivat24 (EUR)
P24UAHПриват 24 (UAH)
P24USDПриват 24 (USD)
PMBBUAHПумб (UAH)
PMEURPerfect Money (EUR)
PMUSDPerfect Money (USD)
PMVUSDPM e-Voucher (USD)
PNRUSDPayoneer (USD)
PPEURPayPal (EUR)
PPGBPPayPal (GBP)
PPUSDPayPal (USD)
PREURPayeer (EUR)
PRUSDPayeer (USD)
RFBUAHАваль (UAH)
RMTFEURRia Financial (EUR)
SKLEURSkrill (EUR)
SKLUSDSkrill (USD)
USDTBEP20USDT BEP20
WCTCNYWeChat (CNY)
WIREEURБудь-який банк (EUR)
WIREGBPБудь-який банк (GBP)
WIREKZTБудь-який банк (KZT)
WIREUAHБудь-який банк (UAH)
WIREUSDБудь-який банк (USD)
WUEURWestern Union (EUR)
WUUSDWestern Union (USD)
XMRMonero (XMR)
ZECZcash (ZEC)
XRPRipple (XRP)
BSVBitcoin (SV)
XEMNEM (XEM)
NEONEO (NEO)
EOSEOS (EOS)
XLMStellar (XLM)
IOTAIOTA (IOTA)
MONOBUAHMonobank (UAH)
USDTERC20USDT ERC20
KSPBKZTKaspi Gold (KZT)
USDTTRC20USDT TRC20
TRXTron (TRX)
CASHAEDГотівка (AED)
CARDAEDVisa/MasterCard (AED)
DAIDAI (USD)
ADACardano (ADA)
OMGOmiseGO (OMG)
BNBBinance Coin (BNB)
LINKChainlink (LINK)
ATOMCosmos (ATOM)
XTZTezos (XTZ)
DOTPolkadot (DOT)
UNIUniswap (UNI)
SOLSolana (SOL)
SHIBShiba Inu (SHIB)
LUNATerra (LUNA)
MATICPolygon (MATIC)
UAHГривня
USDДолари
KZTТенге
EURЄвро
BUSDBinance USD (BUSD)
KSMKusama (KSM)
NEARNear (NEAR)
USDCTRC20USDC (TRC20)
AVAXAvalanche (AVAX)
USDDTRC20USDD (TRC20)
CARDTHBVisa/MasterCard (THB)
CASHTHBГотівка (BAT)
IYBUSDIpakYuliBank
MCBUSDMoldindconbank (USD)
FRBUSDFreedom Bank (USD)
BKKTHBBangkok Bank (THB)
AYUTHBBank of Ayudhya (THB)
ALPCNYAlipay (CNY)
SwiftSwift (USD)
WHTBTUSDTWhiteBIT Code USDT
CARDGELVisa/MasterCard (GEl)
CARDTRYVisa/MasterCard (TRY)
BOAUSDBankofAmerica (USD)
ZELLEUSDZELLE (USD)
MPARSMERCADO PAGO (ARS)