Reference, account and addresses
CoinVertus API: coin and network reference, rates, address checks, balances, history and new addresses.
Contents
API address: https://api.coinvertus.net/v1
Reference calls
assets
The list of “coin × network” pairs the API serves, with what they support. Pairs change rarely — you can keep the directory on your side and refresh it daily.
[
{
"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"
]
}
]| Field | Description |
|---|---|
coin | Coin or token ticker — you can pass it as {COIN}. |
network, network_name, testnet | Network code for network, its name and the testnet flag. |
type, contract | coin is the network coin, token is a token with its contract address in contract. |
decimals | Digits after the dot in amounts. |
formats | Address formats you can request in getnewaddress. |
confirmations | How many confirmations make a transaction confirmed. |
can_send | The pair can be sent through the API: getfee, preparetx, posttx. |
multi_recipient | One transaction can have several recipients. |
tag | The recipient may need a destination tag — to[].tag. |
fee_levels | Fee levels that getfee returns and preparetx accepts in fee: UTXO networks with block-target estimates have fast, normal and low, all others only normal; an empty list means no sending. |
min_amount | Reserved: min_amount is null for now. |
rates, rate/{COIN}
Rates of catalog coins and tokens in USD, EUR, RUB, CNY and INR, 100 per page (page from 1; an empty page ends the list). coins is an optional list of tickers or IDs, up to 100. No rate — null, updated_at is the rate time. rate/{COIN} returns one such item.
{
"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}
Checks an address in the pair network. Request: address, network. Response: valid, address (canonical form), coin, network, format. With a key that has the read right — also is_mine (the address was issued to your account) and balance (its confirmed balance); without a key and for an address of another account — null.
Balances and history
paybalance
The payment balance the service fee is charged from: usd is available, reserved is held in withdrawal requests and in fees of unfinished tasks; auto_topup, threshold, topup_amount are the auto top-up settings (no threshold — false and null).
getbalance[/{COIN}]
Without {COIN} — the pairs where you have addresses; with {COIN} — all networks of the coin, or one if network is given. balance is confirmed, pending is incoming without confirmations, available can be sent now, fiat is balance in five currencies, addresses is the address count, stale means the data may lag behind the network.
[
{
"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}
Issued addresses of the pair in issue order, 100 per page (page): address, format, label, balance, pending, created_at. For a token — the addresses of its network with the token balance.
txinfo/{COIN}, transactions/{COIN}
txinfo is a transaction of your addresses by txid (as the network explorer shows it). A transaction dropped from the mempool is deleted by the monitor: it returns 404 A015, and the tx.dropped webhook reports it.
transactions is the history of your addresses in the pair, 100 per page, newest first, unconfirmed on top. Filters: address — one of your addresses, from and to — transaction time inclusive. New transactions shift the pages — a from/to window is better for reconciliation.
{
"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"
}| Field | Description |
|---|---|
direction | in is incoming, out is from your addresses. |
status | new waits for confirmations, confirmed has at least the pair confirmations, failed means the network rejected the transaction and charged the network fee. |
block, confirmations, time | Block, confirmations and transaction time; while the transaction is in the mempool, block and time are null. |
transfers | Movements on your addresses summed by address and direction. For UTXO, spending is whole inputs and change is a separate in line. tag is the destination tag of an incoming transfer. |
fee, fee_coin | Network fee of an outgoing transaction and its coin (for a token — the network coin). |
Issuing addresses
getnewaddress/{COIN} issues a new address in the pair network. Request: network, format (one of the pair formats), label (up to 190 characters), priv. In a network with destination tags the account has one address — the call issues a new tag for it. CVC sets the quota of addresses issued through the API per account in a network — beyond it, 403 A016.
{
"coin": "DOGE",
"network": "dogecoin-mainnet",
"address": "D8vFz4p1L37jdg47HXKtSHA5uYLYxbGgPD",
"format": "base58",
"tag": null,
"privkey": null
}priv: true (needs the keys right) adds privkey to the response: the private key encrypted with AES-256-GCM. The encryption key is HMAC-SHA256(API key secret, “privkey”) as raw bytes, the value is base64(12-byte nonce ‖ ciphertext ‖ 16-byte tag). In networks where the key belongs to the node wallet, privkey is always null.