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

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