Формат файла с курсами

Структура XML-выгрузки и примеры

Курсы передаются в виде XML-файла, который доступен по постоянной ссылке. Мы считываем его автоматически и не вносим в него изменений.

Структура файла

Корневой элемент содержит набор элементов item, по одному на каждое направление обмена:

<?xml version="1.0" encoding="UTF-8"?>
<rates>
  <item>
    <from>BTC</from>
    <to>SBERRUB</to>
    <in>1</in>
    <out>5120000</out>
    <amount>12.5</amount>
    <minamount>0.001 BTC</minamount>
    <maxamount>2 BTC</maxamount>
    <param>manual</param>
    <city>MSK</city>
  </item>
</rates>

Описание полей

  • from — код валюты, которую отдаёт клиент.
  • to — код валюты, которую получает клиент.
  • in — сколько единиц отдаёт клиент.
  • out — сколько единиц получает клиент за in.
  • amount — резерв: сколько валюты to доступно к выдаче.
  • minamount, maxamount — минимальная и максимальная суммы обмена (необязательно).
  • param — дополнительные условия обмена (необязательно).
  • city — код города для наличных направлений (необязательно).

Коды валют

В полях from и to используются коды из справочника валют. Если вашей валюты в справочнике нет, напишите нам, и мы добавим её.

Рекомендации

  • Файл должен отвечать быстро (не дольше нескольких секунд) и не требовать авторизации.
  • Обновляйте курсы не реже, чем меняются условия на вашем сайте. Устаревшие курсы скрываются из таблиц.
  • Не включайте в файл направления, по которым обмен сейчас не выполняется.