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 |
---|---|
ATNBKZT | Astana Bank (KZT) |
BCBCNY | Bank of China (CNY) |
BCBUSD | Bank of China (USD) |
CASHAMD | Готівка (AMD) |
CCBCNY | China Construction Bank (CNY) |
CMBCNY | China Merchants Bank (CNY) |
CUPCNY | ChinaUnionPay (CNY) |
EURBKZT | Eurasian Bank (KZT) |
EURBUSD | Eurasian Bank (USD) |
FRTBUSD | ForteBank (USD) |
HCSBKZT | Zhilstroysberbank (KZT) |
HLKBUSD | Halyk Bank (USD) |
ICBCCNY | Industrial and Commercial Bank of China (CNY) |
KKBUSD | Kazkombank (USD) |
PNRUSD | Payoneer (USD) |
RMTFEUR | Ria Financial (EUR) |
WCTCNY | WeChat (CNY) |
ALPCNY | Alipay (CNY) |
MPARS | MERCADO PAGO (ARS) |
BTC | Bitcoin (BTC) |
USDCERC20 | USDC (ERC20) |
ETH | Ethereum (ETH) |
USDTERC20 | USDT ERC20 |
USDTTRC20 | USDT TRC20 |
USDTBEP20 | USDT BEP20 |
IYBUSD | Ipak Yuli Bank (USD) |
MCBUSD | Moldindconbank (USD) |
BOAUSD | BankofAmerica (USD) |
ZELLEUSD | ZELLE (USD) |
LTC | Litecoin (LTC) |
SOL | Solana (SOL) |
DOGE | Dogecoin (DOGE) |
WHTBTUSDT | WhiteBIT Code USDT |
BNB | Binance Coin (BNB) |
MONOBUAH | Monobank (UAH) |
P24UAH | Приват 24 (UAH) |
P24USD | Приват 24 (USD) |
P24EUR | Приват 24 (EUR) |
CASHUAH | Готівка (UAH) |
CASHUSD | Готівка (USD) |
CASHEUR | Готівка (EUR) |
CARDGEL | Visa/MasterCard (GEl) |
CARDTRY | Visa/MasterCard (TRY) |
CASHGBP | Готівка (GBP) |
CASHKZT | Готівка (KZT) |
CASHTHB | Готівка (BAT) |
CASHAED | Готівка (AED) |
MGEUR | Moneygram (EUR) |
MGUSD | Moneygram (USD) |
WUEUR | Western Union (EUR) |
WUUSD | Western Union (USD) |
WIREGBP | Будь-який банк (GBP) |
WIREKZT | Будь-який банк (KZT) |
WIREEUR | Будь-який банк (EUR) |
WIREUSD | Будь-який банк (USD) |
WIREUAH | Будь-який банк (UAH) |
CARDGBP | Visa/MasterCard (GBP) |
CARDAMD | Visa/MasterCard (AMD) |
CARDKZT | Visa/MasterCard (KZT) |
CARDEUR | Visa/MasterCard (EUR) |
CARDAED | Visa/MasterCard (AED) |
CARDUSD | Visa/MasterCard (USD) |
CARDTHB | Visa/MasterCard (THB) |
CARDUAH | Visa/MasterCard (UAH) |
FRTBKZT | ForteBank (KZT) |
FRBUSD | Freedom Bank (USD) |
HLKBKZT | HalykBank (KZT) |
KKBKZT | Казкоммерцбанк (KZT) |
KSPBKZT | Kaspi Gold (KZT) |
AYUTHB | Bank of Ayudhya (THB) |
OSDBUAH | Ощад банк (UAH) |
RFBUAH | Аваль (UAH) |
OTPBUAH | ОТП Банк (UAH) |
PMBBUAH | Пумб (UAH) |
BKKTHB | Bangkok Bank (THB) |
Swift | Swift (USD) |
PPGBP | PayPal (GBP) |
PPEUR | PayPal (EUR) |
PPUSD | PayPal (USD) |
SKLEUR | Skrill (EUR) |
SKLUSD | Skrill (USD) |
NTLREUR | Neteller (EUR) |
NTLRUSD | Neteller (USD) |
CPTSUSD | Capitalist (USD) |
PREUR | Payeer (EUR) |
PRUSD | Payeer (USD) |
EXMEUR | Exmo (EUR) |
EXMUSD | Exmo (USD) |
ADVCEUR | Volet (Advcash) (EUR) |
ADVCUSD | Volet (Advcash) (USD) |
PMVUSD | PM e-Voucher (USD) |
PMEUR | Perfect Money (EUR) |
PMUSD | Perfect Money (USD) |
USDCTRC20 | USDC (TRC20) |
DAI | DAI (USD) |
EOS | EOS (EOS) |
LINK | Chainlink (LINK) |
ATOM | Cosmos (ATOM) |
POL | Polygon (POL) |
SHIB | Shiba Inu (SHIB) |
ZEC | Zcash (ZEC) |
NEO | NEO (NEO) |
XMR | Monero (XMR) |
DASH | Dash (DASH) |
XLM | Stellar (XLM) |
XTZ | Tezos (XTZ) |
UNI | Uniswap (UNI) |
AVAX | Avalanche (AVAX) |
NEAR | Near (NEAR) |
KSM | Kusama (KSM) |
DOT | Polkadot (DOT) |
ADA | Cardano (ADA) |
XRP | Ripple (XRP) |
TRX | Tron (TRX) |
TON | Toncoin (TON) |
ETC | Ethereum Classic (ETC) |
BCH | Bitcoin Cash (BCH) |
EUR | Євро |
KZT | Тенге |
UAH | Гривня |
USD | Долари |
UAHGTRC20 | UAHg TRC20 (UAHG) |