Exchanger Integration Guide

A properly built XML file is the key to a successful listing of your exchanger service on the OKchanger website. Depending on the accuracy of the file, your exchanger might have a bigger chance of being featured before others on the OKchanger list. Please note, that the information presented in the XML file should 100% match the information on your website. If you state better rates in the XML file which do not correspond to the actual rates on your websites, we will disable your exchanger listing.

This page contains a description of the common standard of rates export files supported by OKchanger. The standard is XML-based; currency abbreviations are taken from Estandards.

• The export file is created in the XML format;
• Insert a line break to add a new entry. To insert a line break use the character \n.
• Use the dot symbol (.) to insert a decimal point for numerical values;
• Use as the root element;
• Every exchange direction is described in the element;
• Exchange rates and currency reserves are described in the following elements:
• <from> – source currency code. Electronic currency codes are given below;
• <to> – destination currency code. Electronic currency codes are given below;
• <in> – the amount of source currency the customer wants to exchange;
• <out> – the amount of target currency the customer will receive;
• <amount> – exchanger's reserve in the target currency.
• Additional information on the accurate integration with OKchanger (if your exchanger charges a minimum or an extra fee or performs the exchange of certain currency pairs only upon request, the below parameters must be specified in your export file):
• <minfee> – minimum fee charged by the exchanger for the exchange of the given currency pair.
Example: <minfee>5 USD</minfee>
• <fromfee> – an extra fee that is added to the exchange rate and is deducted from the amount the customer transfers to the exchanger.
Example: <fromfee>2.15 EUR</fromfee>
• <tofee> – an extra fee that is added to the exchange rate and is deducted from the amount the exchanger transfers to the customer.
Example: <tofee>2 EUR</tofee>

Example of a correct XML file:

<rates>
  <item>
    <from>BTC</from>
    <to>OKUSD</to>
    <in>1</in>
    <out>248.0100</out>
    <amount>10237.86024</amount>
  </item>
  <item>
    <from>OKUSD</from>
    <to>BTC</to>
    <in>1</in>
    <out>0.004032</out>>
    <amount>165.26734</amount>
  </item>
  <item>
   <from>BTC</from>
   <to>PMUSD</to>
   <in>1</in>
   <out>248.0100</out>
   <amount>10237.86024</amount>
  </item>
 </rates>

Supported currency codes are given below. We highly recommend that you use the codes that are written in bold, but the other codes presented in the table are supported as well.

If you provide additional exchange directions that are not included in the tables below, please contact us and we will add them to the directory.