参考调用、账户与地址
CoinVertus API：币种与网络参考、汇率、地址校验、余额、历史与新地址。
目录
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 Webhook 会通知此事。
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 密钥 secret, “privkey”) 的原始字节，值为 base64(12 字节 nonce ‖ 密文 ‖ 16 字节标签)。在私钥属于节点钱包的网络中，privkey 始终为 null。