Вызов

Все запросы можно отправлять методами GET или POST (в формате form-urlencoded или JSON).
Ключ API можно передавать отдельно в HTTP заголовке в поле CCAPI-KEY (cм. пример в разделе Тестирование).

Ответ возвращается в формате JSON и после преобразования представляет собой массив.

В случае успеха результат возвращается в поле result:
{"result":12.345}

Иначе код ошибки в поле error и доп.информация в поле value:
{"error":"allowed_ip_required","value":"127.0.0.1"}

НЕобязательные параметры помечены * и могут быть опущены (НЕ указаны).
Если в имени параметра несколько вариантов - можно использовать любое.
В квадратных скобках указано значение по-умолчанию.

Тестирование


Эхо
Возвращает параметры запроса и IP адрес (с которого поступил запрос), в том виде как их видит сервис.

1) Пример запроса GET:
https://new.cryptocurrencyapi.net/api/echo?a=1&b=2&key=5678

2) Пример запроса POST:
curl -L 'https://new.cryptocurrencyapi.net/api/echo' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'CCAPI-KEY: 5678' \
-d 'a=1' \
-d 'b=2'


3) Пример запроса POST (JSON):
curl -L 'https://new.cryptocurrencyapi.net/api/echo' \
-H 'Content-Type: application/json' \
-H 'CCAPI-KEY: 5678' \
-d '{
   "a": 1,
   "b": 2
}'


Все три примера выдают одинаковый результат:
{"result":{"a":"1","b":"2","key":"5678"},"ip":"192.168.0.1"}

Методы сервиса


Метод marketPrices
Возвращает приблизительную рыночную стоимость основных монет. Значения обновляются каждую минуту

https://new.cryptocurrencyapi.net/api/.marketPrices?key={API_ключ}
Результат:
{"result":{"BTC":72694.55818752,"LTC":95.844940202,..

Метод units
Возвращает кол-во единиц
https://new.cryptocurrencyapi.net/api/.units?key={API_ключ}
Результат:
{"result":12345}

Метод buyUnits
Запускает принудительно автопокупку
https://new.cryptocurrencyapi.net/api/.buyUnits?key={API_ключ}
Результат:
Возвращает ID заявки в очереди отправок
{"result":12345}

Метод QR
Возвращает содержимое картинки QR-кода
https://new.cryptocurrencyapi.net/api/.QR?key={API_ключ}&text=TKavpKP2VJbfV4AGyi3MrhT6FJAP5eJ2RR
Результат:
{"result":"data:image\/png;base64, iVBORw0KGgoAAAA...hcwAAAABJRU5ErkJggg=="}

Метод stop
https://new.cryptocurrencyapi.net/api/.stop?key={API_ключ}
Этот метод мгновенно останавливает все отправки. После этого (на данный момент) восстановить работу отправок можно только через поддержку. Это можно использовать как “красную кнопку” в экстренных случаях. То есть это временная блокировка всех счетов.

Методы сетей

https://new.cryptocurrencyapi.net/api/сеть/.метод?key={API_ключ}&параметр1={значение1}&параметр2={значение2}..
где сеть = tron / ethereum / bsc / polygon / bitcoin / litecoin / dogecoin / dash / bitcoincash / ripple / ton / solana
ИЛИ также можно использовать значения = trx / eth / bnb / matic / btc / ltc / doge / dash / bch / xrp / ton / sol

Параметр token имеет смысл только для сетей tron / ethereum / bsc / polygon
Если параметр token НЕ указан (или пусто), то значит запрос про основную монету сети
label (метка) - любая строка до 200 символов.
uniqID - любая строка любой длины.
statusURL - валидный URL до 250 символов

Пример:
https://new.cryptocurrencyapi.net/api/eth/.balance?key={API_ключ}&from={адрес}


Метод primary