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

На этой странице приводится описание стандарта, поддерживаемого службой мониторинга для создания файла экспорта, содержащего направления обмена. Чтобы добавить обменник в список, необходимо предоставить ссылку на этот файл, размещенный на вашем веб-сайте. Пример содержимого файла приведен ниже: XML | JSON | Коды | Примеры

Правила создания файлов в формате XML

1. Каждая запись начинается с новой строки. Разрывы строк обозначаются символом\n.
2. В числовых значениях целая часть отделяется точкой.
3. Кореневым элементом является rates.
4. Каждое направление обмена описывается в элементе item.
5. Обязательные элементы для указания направления обмена внутри элемента item.
  • <from> Код валюты, который обменник принимает от клиента.
  • <to> Код валюты, который обменник отправляет клиенту.
  • <in> Чтобы указать обменный курс, сколько валютыfromклиент должен предоставить.
  • <out> Чтобы указать обменный курс, сколькоtoвалюте получит клиент.
  • <amount> Размер резерва валютыtoв обменном пункте, максимум, который может получить клиент.
  • <minamount> Минимальная возможная к обмену сумма валюты, которую обменный пункт принимает от клиента. Указывается в валютеfrom. <minamount>2.4</minamount>
  • <maxamount> Максимальная возможная к разовому обмену сумма валюты, которую обменный пункт принимает от клиента. Указывается в валютеfrom. <maxamount>1000</maxamount>
6. Дополнительные элементы для описания направления обмена внутри элементаitem.
  • <fromfee> Дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую клиент переводит в обменный пункт. Указывается в валютеfrom. <fromfee>1.54</fromfee>. Возможно также использование знака%для обозначения процентной комиссии.
  • <tofee> Дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую обменный пункт переводит клиенту. Указывается в валютеto. <tofee>0.0123</tofee>. Возможно также использование знака%для обозначения процентной комиссии
  • <minfee> Mинимальная комиссия, которая рассчитывается для разницы между отдаваемой суммой и эквивалентом получаемой валюты относительно среднего биржевого курса. Указывается абсолютное значение в валютеfrom. <minfee>2</minfee>
  • <floating> Для установки метки плавающего курса. Указывается время в минутах, на которое курс обмена будет фиксироваться. Указывается значение 0 в случае отсутствия фиксации. Возможно также использование знака%для обозначения фиксации курса обмена до момента изменения биржевого курса обмена на указанный процент. <floating>0.0123</floating>
  • <delay> Параметр, указывающий на отложенный обмен. Продолжительность задержки необходимо указать в минутах.
  • <param> Данный элемент служит для указания дополнительных меток:
    • manual Для указания метки ручного обмена, которая должна присутствовать для направлений обмена, которые обрабатываются через оператора вручную.
    • juridical Обменник переводит средства на банковский счет клиента со счета юридического лица или индивидуального предпринимателя.
    • verifying При обмене может потребоваться проверка документов и личности клиента.
    • cardverify Для обмена требуется подтверждение карты.
    • otherin Платежи от клиентов принимаются через стороннюю платежную систему.
    • otherout Выплата средств клиенту осуществляется через стороннюю платежную систему.
    • reg Для создания заявки требуется регистрация на сайте.
    • delivery У обменного пункта нет офиса в выбранном городе; стоимость курьерской доставки включена в курс обмена или указана в метке.
    • anonim Для проведения обмена не требуются личные данные пользователя и верификация карты.
    • card2card Биржа принимает средства пользователей посредством переводов Card2Card (не через платежную систему).
    • atm Обмен осуществляется через криптомат — терминал, установленный в этом городе.
    • floating Курс обмена в приложении не является фиксированным. Сумма обмена может измениться на момент отправки средств клиенту.
    • Если меток несколько, они указываются через запятую.<param>manual,anonim</param>
  • <city> Used to specify the city for cash exchange destinations.<city>DUBAI</city>. If the exchange conditions are the same in several cities, it is permitted to specify several cities within oneitemelement, separated by commas.<city>DUBAI,ADLD,NSN</city>
  • Дополнительные сборы, взимаемые с клиента, должны быть указаны в элементахfromfeeиtofee, или включены в тарифы.

Правила создания формата JSON

1. Все начинается с такой конструкции.{"version":"1.3"}
2. Укажите список валют. Он должен состоять из пар в формате «код валюты: номер валюты». Номер валюты не может равняться 0 и должен состоять из цифр от 1 до 0..
{"version":"1.3","currencies":{"list":{"1":"PMUSD","2":"BTC","3":"ETH"}}}
3. Следующим шагом будет указание обменов. В примере ниже указаны следующие обмены: exchange -> номер входящей валюты -> to -> номер исходящей валюты.
{"version":"1.3","currencies":{"list":{"1":"PMUSD","2":"BTC","3":"ETH"}},"exchange":{"1":{"to":{"2":[],"3":[]}},"2":{"to":{"1":[]}},"3":{"to":{"1":[]}}}}
4. Каждый курс должен быть кратен 1; то есть либо 1 = X, либо X = 1, где X должно быть числом, большим или равным 1. Существует два способа указания курса валюты в файле: краткая форма и расширенная форма. Используйте краткую форму, если не требуется указывать никакой другой информации, кроме курса валюты. Во всех остальных случаях используйте расширенную форму.
{"version":"1.3","currencies":{"list":{"1":"PMUSD","2":"BTC","3": "ETH"}},"exchange":{"1":{"to":{"2":-57.8,"3":8625.983721}},"2":{"to":{"1":{"xr":60}}},"3":{"to":{"1":{"xr":-8594.7463}}}}}
5. Валютные резервы, как и валюты, также указываются в виде списка. Список должен состоять из код валюты: резервные пары. В качестве кода валюты необходимо указать код, под которым валюта отображается в списке валют. В качестве резерва укажите сумму валюты, доступную для обмена. Иногда необходимо указать индивидуальный резерв для конкретной биржи; в этом случае его следует указать в поле amount в деталях для данной биржи, как показано в примере ниже.
{"version":"1.3","currencies":{"list":{"1":"PMUSD","2":"BTC","3": "ETH"},"amounts":{"1":945.54,"2":12500,"3":0.67231509}},"exchange":{"1":{"to":{"2":-57.8,"3":8625.983721}},"2":{"to":{"1":{"xr":60,"amount":300}}},"3":{"to":{"1":-8594.7463}}}}

Пример файла экспорта в формате XML

version 1.0
<rates>
    <item>
        <from>USDTTRC20</from>
        <to>BTC</to>
        <in>68803.827</in>
        <out>1</out>
        <amount>12466826.1055</amount>
        <minamount>500</minamount>
        <maxamount>5000</maxamount>
        <tofee>0.54</tofee>
        <delay>10</delay>
        <param>manual,juridical,verifying</param>
    </item>
    <item>
        <from>BTC</from>
        <to>CASHUSD</to>
        <in>1</in>
        <out>68803.827</out>
        <amount>10</amount>
        <minamount>0.18</minamount>
        <maxamount>9.8</maxamount>
        <city>ANTW</city>
    </item>
</rates>

Пример файла экспорта в формате JSON

version 1.3
{
  "version": "1.3",
  "currencies": {
    "list": {
      "1": "USDTTRC20",
      "2": "CASHUSD",
      "3": "BTC",
      "4": "USDTERC20",
      "5": "ETH",
    },
    "amounts": {
      "1": 334386.07,
      "2": 198000,
      "3": 100.18,
      "4": 2160029,
      "5": 10004.79,
    }
  },
  "exchange": {
    "1": {
      "to": {
        "2": 1,
        "4": {
          "outFee": 4,
          "options": {
            "manual": 0
          },
          "min": 100,
          "max": 20000,
          "xr": 1.005
        }
      },
      "min": 1000,
      "max": 150000
    },
    "2": {
      "to": {
        "1": {
          "outFee": 2,
          "xr": 1.033
        },
        "3": {
          "outFee": 0.00055,
          "min": 1000,
          "max": 150000,
          "xr": 73968.95996
        },
        "4": {
          "outFee": 4,
          "min": 1038,
          "max": 154955,
          "xr": 1.033
        },
        "5": {
          "outFee": 0.004,
          "min": 1000,
          "max": 150000,
          "xr": 2271.96872
        }
      },
      "cities": [
        "DUBAI"
      ],
      "min": 1036,
      "max": 154953
    },
    "3": {
      "to": {
        "2": {
          "cities": [
            "MIAMI"
          ],
          "xr": -71185.054835
        }
      },
      "min": 0.0141,
      "max": 2.1072
    },
    "4": {
      "to": {
        "1": {
          "outFee": 2,
          "options": {
            "manual": 0
          },
          "min": 100,
          "max": 20000,
          "xr": 1.005
        },
        "2": 1
      },
      "min": 1000,
      "max": 150000
    },
    "5": {
      "to": {
        "2": {
          "cities": [
            "BER"
          ],
          "xr": -2186.460618
        }
      },
      "min": 0.4578,
      "max": 68.6045
    }
  },
  "options": {
    "manual": 1
  }
}