Вызов
Все запросы можно отправлять методами 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
Возвращает приблизительную рыночную стоимость основных монет. Значения обновляются каждую минуту
Результат:
{"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 →