Фрагмент валют

Этот фрагмент указывается в основном только тогда, когда необходимо произвести оптимизацию файла, уменьшить его объем.

Он имеет название currencies, и может содержать такие фрагменты:

aliases
фрагмент псевдонимов сигнатур;
amounts
фрагмент резервов;
fees
фрагмент комиссий.

Ниже приведен пример, который иллюстрирует структуру этого фрагмента.

В этом примере наглядно показано использование этого фрагмента.


Фрагмент псевдонимов сигнатур

Этот фрагмент позволяет уменьшить объем файла, путем замены длинных сигнатур валют, на более короткие. Оптимальнее всего, использовать цифры вместо сигнатур.

Он имеет название aliases, и должен полностью состоять из элементов, в качестве названий которых должны быть использованы псевдонимы валют, а в качестве их значений сигнатуры валют, которые соответствуют этим псевдонимам.

В примере ниже, указано псевдонимы 1 и 2 для валют PMUSD и BTC.

Все псевдонимы должны быть использованы в фрагменте курсов обмена. Если в этом фрагменте будут появляться не используемые псевдонимы то, их необходимо удалить.

В этом примере можно увидеть, как правильно указывать этот фрагмент.


Фрагмент резервов

Этот фрагмент позволяет уменьшить объем файла, путем объединения в себе резервов всех валют из фрагментов с информацией о курсе обмена (элемент amount).

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

В примере ниже, указано резервы для валют с псевдонимами 1 и 2.

Если, для какой-либо из валют, указан резерв в этом фрагменте то, указывать его в фрагменте с информацией о курсе обмена не нужно. Исключение составляют только те ситуации, когда в фрагменте с информацией о курсе обмена, требуется указать другой резерв, отличный о того, который указан в этом фрагменте.

Если, в фрагментах с информацией о курсе обмена больше не будет валют, для которых указан резерв, или же для всех них указан резерв, отличающийся от указанного в этом фрагменте то, такие резервы необходимо удалить из этого фрагмента.

В этом примере можно увидеть, как правильно указывать этот фрагмент.


Фрагмент комиссий

Этот фрагмент позволяет уменьшить объем файла, путем объединения в себе значений элементов комиссий из фрагментов с информацией о курсе обмена.

Он имеет название fees, и должен полностью состоять из элементов, в качестве названий которых должны быть использованы сигнатуры валют или их псевдонимы, а их значениями должны быть фрагменты, содержащие только такие элементы:

in
если есть комиссия на прием валюты, то есть, в фрагментах с информацией о курсах обмена, где принимается эта валюта, есть элемент in_fee;
out
если есть комиссия на перевод валюты, то есть, в фрагментах с информацией о курсах обмена, где переводится эта валюта, есть элемент out_fee.

Если значение будет содержать фрагмент, содержащий оба елемента (in и out) и, значения этих элементов будут одинаковы то, этот фрагмент можно заменить значением одного из этих элементов.

В примере ниже, указано комиссию на прием валюты с псевдонимом 2.

Если, для какой-либо из валют, указана комиссия в этом фрагменте то, указывать ее в фрагменте с информацией о курсе обмена не нужно. Исключение составляют только те ситуации, когда в фрагменте с информацией о курсе обмена, требуется указать другую комиссию, отличную о той, которая указана в этом фрагменте.

Если, в фрагментах с информацией о курсе обмена больше не будет валют на прием и, при этом, для них указана комиссия на прием или, больше не будет валют на перевод и, при этом, для них указана комиссия на перевод, или же для всех них указана комиссия, отличающаяся от указанной в этом фрагменте то, такие комиссии необходимо удалить из этого фрагмента.

В этом примере можно увидеть, как правильно указывать этот фрагмент.


Пример

В примере указано 4 курса обмена:

  1. Курс обмена PMUSD на YAMRUB в соотношении 1 = 58.1201. Обменять можно максимум 23013.36 YAMRUB причем, из суммы получения (в YAMRUB) будет еще вычтено 0.5%.
  2. Курс обмена YAMRUB на PMUSD в соотношении 58.6251 = 1. Обменять можно максимум 3524.3 PMUSD причем, необходимо будет еще заплатить дополнительную комиссию 0.5% в YAMRUB.
  3. Курс обмена P24UAH на PMUSD в соотношении 26.3703 = 1. Обменять можно максимум 3524.3 PMUSD причем, необходимо будет еще заплатить дополнительную комиссию 2% в P24UAH.
  4. Курс обмена P24UAH на YAMRUB в соотношении 1 = 2.2839. Обменять можно максимум 30000 YAMRUB причем, необходимо будет еще заплатить дополнительную комиссию 2% в P24UAH, а из суммы получения (в YAMRUB) будет вычтено 50 YAMRUB.