Справочные вызовы, аккаунт и адреса
API CoinVertus: справочник монет и сетей, курсы, проверка адресов, балансы, история и выдача адресов.
Содержание
Адрес API: https://api.coinvertus.net/v1
Справочные вызовы
assets
Список пар «монета × сеть», которые обслуживает API, и их возможности. Пары меняются редко — справочник можно хранить у себя и обновлять раз в сутки.
[
{
"coin": "DOGE",
"name": "Dogecoin",
"network": "dogecoin-mainnet",
"network_name": "Dogecoin",
"testnet": false,
"type": "coin",
"contract": null,
"decimals": 8,
"formats": [
"base58"
],
"confirmations": 6,
"min_amount": null,
"can_send": true,
"multi_recipient": true,
"tag": false,
"fee_levels": [
"fast",
"normal",
"low"
]
}
]| Поле | Описание |
|---|---|
coin | Тикер монеты или токена — его можно передавать в {COIN}. |
network, network_name, testnet | Код сети для network, её название и признак тестовой сети. |
type, contract | coin — монета сети, token — токен с адресом контракта в contract. |
decimals | Знаков после точки в суммах. |
formats | Форматы адресов, которые можно запросить в getnewaddress. |
confirmations | Сколько подтверждений нужно, чтобы транзакция стала confirmed. |
can_send | Пару можно отправлять через API: getfee, preparetx, posttx. |
multi_recipient | В одной транзакции можно указать несколько получателей. |
tag | У получателя бывает тег назначения — to[].tag. |
fee_levels | Уровни комиссии, которые отдаёт getfee и принимает preparetx в fee: у UTXO с оценкой по блокам — fast, normal и low, у остальных — только normal; пустой список — отправки нет. |
min_amount | Зарезервировано: min_amount пока null. |
rates, rate/{COIN}
Курсы монет и токенов каталога в USD, EUR, RUB, CNY и INR, страницами по 100 (page от 1; пустая страница — конец списка). coins — необязательный список тикеров или ID, до 100. Нет курса — null, updated_at — время курса. rate/{COIN} возвращает один такой элемент.
{
"coin": "DOGE",
"id": "dogecoin",
"name": "Dogecoin",
"usd": "0.2251",
"eur": "0.2089",
"rub": "18.42",
"cny": "1.6237",
"inr": "18.91",
"updated_at": "2026-09-17T12:10:00Z"
}checkaddress/{COIN}
Проверяет адрес в сети пары. Запрос: address, network. Ответ: valid, address (в каноническом виде), coin, network, format. С ключом с правом read — ещё is_mine (адрес выдан вашему аккаунту) и balance (его подтверждённый баланс); без ключа и для чужого адреса — null.
Балансы и история
paybalance
Платёжный баланс, с которого списывается комиссия сервиса: usd — доступно, reserved — в заявках на вывод и в комиссиях незавершённых задач; auto_topup, threshold, topup_amount — настройки автопополнения (порога нет — false и null).
getbalance[/{COIN}]
Без {COIN} — пары, где у вас есть адреса; с {COIN} — все сети монеты или одна, если указан network. balance — подтверждённый баланс, pending — входящие без подтверждений, available — можно отправить сейчас, fiat — balance в пяти валютах, addresses — число адресов, stale — данные могут отставать от сети.
[
{
"coin": "DOGE",
"network": "dogecoin-mainnet",
"type": "coin",
"balance": "250",
"pending": "0",
"available": "250",
"fiat": {
"usd": "56.28",
"eur": "52.23",
"rub": "4605",
"cny": "405.93",
"inr": "4727.5"
},
"addresses": 3,
"updated_at": "2026-09-17T12:10:00Z",
"stale": false
}
]addresses/{COIN}
Выданные адреса пары в порядке выдачи, по 100 на страницу (page): address, format, label, balance, pending, created_at. У токена — адреса его сети с балансом токена.
txinfo/{COIN}, transactions/{COIN}
txinfo — транзакция ваших адресов по txid (в том виде, как его показывает обозреватель сети). Транзакцию, выпавшую из mempool, монитор удаляет: на неё 404 A015, а вебхук tx.dropped сообщит об этом.
transactions — история ваших адресов в паре по 100 на страницу, новые сверху, неподтверждённые первыми. Фильтры: address — свой адрес, from и to — время транзакции включительно. Новые транзакции сдвигают страницы — для сверки удобнее окно from/to.
{
"txid": "c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0",
"coin": "DOGE",
"network": "dogecoin-mainnet",
"direction": "in",
"status": "confirmed",
"confirmations": 6,
"block": 5912340,
"time": "2026-09-17T12:04:00Z",
"transfers": [
{
"address": "DLp4hPWtqM8sQZoyk2vRj3TfGcX5nA7bUe",
"direction": "in",
"amount": "250",
"tag": null
}
],
"fee": null,
"fee_coin": "DOGE"
}| Поле | Описание |
|---|---|
direction | in — входящая, out — с ваших адресов. |
status | new — ждёт подтверждений, confirmed — подтверждений не меньше confirmations пары, failed — сеть отклонила транзакцию, комиссия сети списана. |
block, confirmations, time | Блок, подтверждения и время транзакции; пока транзакция в mempool, block и time равны null. |
transfers | Движения по вашим адресам, сложенные по адресу и направлению. У UTXO расход — входы целиком, сдача — отдельной строкой in. tag — тег назначения входящего перевода. |
fee, fee_coin | Комиссия сети исходящей транзакции и её монета (у токена — монета сети). |
Выдача адресов
getnewaddress/{COIN} выдаёт новый адрес в сети пары. Запрос: network, format (один из formats пары), label (подпись до 190 символов), priv. В сети с тегом назначения адрес аккаунта один — вызов выдаёт к нему новый tag. Квоту адресов, выданных через API, на аккаунт в сети задаёт CVC — сверх неё 403 A016.
{
"coin": "DOGE",
"network": "dogecoin-mainnet",
"address": "D8vFz4p1L37jdg47HXKtSHA5uYLYxbGgPD",
"format": "base58",
"tag": null,
"privkey": null
}priv: true (нужно право keys) — в ответе privkey: приватный ключ, зашифрованный AES-256-GCM. Ключ шифрования — HMAC-SHA256(секрет ключа API, «privkey») в байтах, значение — base64(nonce 12 байт ‖ шифртекст ‖ метка 16 байт). В сетях, где ключ принадлежит кошельку ноды, privkey всегда null.