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