Функции определения курсов валют

1. Курс одной валютной пары
2. Курсы всех валютных пар
API-запрос осуществляется методом POST протокола HTTP к одному из указанных в Кабинете хостов. Общий вид URL API-запроса:
http(s)://API_HOST/v1/<function>/<params>
Тело (DATA) POST-запроса всегда состоит из трех параметров:
public_key=<PUBLIC_KEY>&rnd=<RND>&signature=<SIGNATURE>
PUBLIC_KEY – открытый ключ пользователя, RND – случайный набор латинских букв и цифр, SIGNATURE – подпись запроса, PRIVATE_KEY – закрытый ключ пользователя.
Открытый и закрытый ключи пользователя уникальны для каждого пользователя и отображены в Кабинете. RND генерирует отправитель запроса, в целях безопасности рекомендуется генерировать новый RND на каждый запрос.
Во всех приведенных ниже примерах открытый ключ (PUBLIC_KEY):
67DbHjAodk9Cbic98mG98492d4N1IB29m51P3j
закрытый ключ (PRIVATE_KEY):
35CJ1KMG57HPjNaF4MCEe9HiAEKF39eNigikJ2393
RND:
J04PDiMH9pH2k10Il713D5c76f1
За каждый API-запрос начисляется определенное количество баллов (вес функции), сумма таких баллов полученных за 1 минуту не должна превышать лимит установленный для пользователя, который по умолчанию равен 10. Свяжитесь с тех. поддержкой для увеличения лимита.

1. Функция rates-specific

Вес функции rates-specific равен 1 баллу.

Общий вид

http(s)://API_HOST/v1/rates/<CURRENCY_PAIR>
CURRENCY_PAIR – название валютной пары.
SIGNATURE вычисляется по формуле:
SHA512(PUBLIC_KEY+';'+RND+';'+CURRENCY_PAIR+';'+PRIVATE_KEY)

Ответ (JSON)

{
cp: CURRENCY_PAIR,
last: LAST_VALUE,
average: AVERAGE_VALUE,
created_at: CREATED_AT
}
CURRENCY_PAIR – название валютной пары, LAST_VALUE – текущее значение курса, AVERAGE_VALUE – среднее скользящее значение курса валютной пары за 24 часа ((HIGH+LOW)/2), CREATED_AT – время замера курса.
LAST_VALUE – медианное значение курса валютной пары со множества (более 10) крупнейших криптовалютных бирж.
Замер курса валютной пары (CREATED_AT) осуществляется несколько раз в час. Подробнее об интервале замера узнавайте у тех. поддержки.

Пример

URL ЗАПРОСА:
http(s)://API_HOST/v1/rates/btcusdt
DATA ЗАПРОСА:
public_key=67DbHjAodk9Cbic98mG98492d4N1IB29m51P3j&rnd=J04PDiMH9pH2k10Il713D5c76f1&signature=15df9cf64354cb623545d570ef24195d7e21ab1fb5e51cceab7f3d71cb52ce130181a9f9fc08217962c9c08aa09ea1b772e7f02300cd988a2dae58c1615d9aab
JSON-ОТВЕТ:
{"cp":"btcusdt", "last":"22915.559999999998", "average":"22959.355", "created_at":"2022-08-05T23:00:20.000+03:00"}

2. Функция rates-all

Вес функции rates-all равен 2 баллам.

Общий вид

http(s)://API_HOST/v1/rates
SIGNATURE вычисляется по формуле:
SHA512(PUBLIC_KEY+';'+RND+';'+PRIVATE_KEY)

Ответ (JSON)

[
{
cp: CURRENCY_PAIR_1,
last: LAST_VALUE_1,
average: AVERAGE_VALUE_1,
created_at: CREATED_AT_1
},
{
cp: CURRENCY_PAIR_2,
last: LAST_VALUE_2,
average: AVERAGE_VALUE_2,
created_at: CREATED_AT_2
},
...
{
cp: CURRENCY_PAIR_N,
last: LAST_VALUE_N,
average: AVERAGE_VALUE_N,
created_at: CREATED_AT_N
}
]
Значения CURRENCY_PAIR_(1,2,...,N), LAST_VALUE_(1,2,...,N), AVERAGE_VALUE_(1,2,...,N), CREATED_AT_(1,2,...,N) аналогичны подобным в функции rates-specific.

Пример

URL ЗАПРОСА:
http(s)://API_HOST/v1/rates
DATA ЗАПРОСА:
public_key=67DbHjAodk9Cbic98mG98492d4N1IB29m51P3j&rnd=J04PDiMH9pH2k10Il713D5c76f1&signature=f01a58246dd7cac4dc6931df3140766a7f7197958d843cefde9a4c1970e461aa66a7a84aad316c44ae4ee3187b7fc986e7deb6466c4b9e61bbcf9d4b09daeafd
JSON-ОТВЕТ:
[{"cp":"btcusd", "last":"23051.81", "average":"22938.124499999998", "created_at":"2022-08-05T17:00:15.000+03:00"}, {"cp":"btcusdt", "last":"23052.09", "average":"22932.620000000003", "created_at":"2022-08-05T17:00:21.000+03:00"}, {"cp":"btceur", "last":"22653.47", "average":"22418.425", "created_at":"2022-08-05T17:00:25.000+03:00"}, {"cp":"btcrub", "last":"1403889.0", "average":"1401240.5", "created_at":"2022-08-05T17:00:26.000+03:00"}, {"cp":"btcuah", "last":"913457.99", "average":"892016.2525", "created_at":"2022-08-05T17:00:26.000+03:00"}, {"cp":"ltcbtc", "last":"0.002645", "average":"0.0026185949999999996", "created_at":"2022-08-05T17:00:30.000+03:00"}, {"cp":"ltcusd", "last":"60.9525", "average":"60.455", "created_at":"2022-08-05T17:00:32.000+03:00"}, {"cp":"ltcusdt", "last":"60.97", "average":"60.45", "created_at":"2022-08-05T17:00:35.000+03:00"}, {"cp":"ltceur", "last":"59.945", "average":"59.087500000000006", "created_at":"2022-08-05T17:00:36.000+03:00"}, {"cp":"ethbtc", "last":"0.073113", "average":"0.07184", "created_at":"2022-08-05T17:00:41.000+03:00"}, {"cp":"ethusd", "last":"1684.5749999999998", "average":"1653.3075", "created_at":"2022-08-05T17:00:43.000+03:00"}, {"cp":"ethusdt", "last":"1684.6480000000001", "average":"1652.9775", "created_at":"2022-08-05T17:00:47.000+03:00"}, {"cp":"etheur", "last":"1656.12", "average":"1614.9850000000001", "created_at":"2022-08-05T17:00:49.000+03:00"}, {"cp":"ethrub", "last":"102581.5", "average":"101022.75", "created_at":"2022-08-05T17:00:50.000+03:00"}, {"cp":"dashbtc", "last":"0.002215", "average":"0.0021850000000000003", "created_at":"2022-08-05T17:00:53.000+03:00"}, {"cp":"dashusd", "last":"51.05", "average":"50.245000000000005", "created_at":"2022-08-05T17:00:54.000+03:00"}, {"cp":"dashusdt", "last":"51.03", "average":"50.230000000000004", "created_at":"2022-08-05T17:00:56.000+03:00"}, {"cp":"dasheur", "last":"50.2705", "average":"49.74075", "created_at":"2022-08-05T17:00:56.000+03:00"}, {"cp":"xmrbtc", "last":"0.0068590000000000005", "average":"0.00694925", "created_at":"2022-08-05T17:00:58.000+03:00"}, {"cp":"xmrusd", "last":"158.3", "average":"159.435", "created_at":"2022-08-05T17:00:59.000+03:00"}, {"cp":"xmrusdt", "last":"158.05825", "average":"159.4675", "created_at":"2022-08-05T17:01:01.000+03:00"}, {"cp":"xmreur", "last":"155.23", "average":"155.755", "created_at":"2022-08-05T17:01:01.000+03:00"}, {"cp":"zecbtc", "last":"0.0029443", "average":"0.0028692500000000003", "created_at":"2022-08-05T17:01:04.000+03:00"}, {"cp":"zecusd", "last":"67.72999999999999", "average":"66.0085", "created_at":"2022-08-05T17:01:06.000+03:00"}, {"cp":"zecusdt", "last":"67.76400000000001", "average":"66.0325", "created_at":"2022-08-05T17:01:07.000+03:00"}, {"cp":"zeceur", "last":"66.308", "average":"64.666", "created_at":"2022-08-05T17:01:08.000+03:00"}, {"cp":"bchbtc", "last":"0.005972", "average":"0.0059465", "created_at":"2022-08-05T17:01:12.000+03:00"}, {"cp":"bchusd", "last":"137.67", "average":"136.51", "created_at":"2022-08-05T17:01:15.000+03:00"}, {"cp":"bchusdt", "last":"137.65", "average":"136.46499999999997", "created_at":"2022-08-05T17:01:18.000+03:00"}, {"cp":"bcheur", "last":"135.25", "average":"133.46249999999998", "created_at":"2022-08-05T17:01:19.000+03:00"}]