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

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 баллам.