费用与发送

CoinVertus API：网络手续费、来源选择、发送计划、确认、任务及其状态。

目录

API 地址： https://api.coinvertus.net/v1

发送流程

  1. getfee：fast、normal、low 三档网络手续费及服务费；spendinfo：资金将从哪些地址转出。
  2. preparetx：转账计划，包括来源、收款方、手续费和步骤。计划不预留任何资金，有效期 5 分钟（expires_at）。
  3. 核对计划并确认：调用 posttx，传入 prepare_id 和 confirm = HMAC-SHA256(密钥 secret, “key_id.fingerprint.prepare_confirm.prepare_time”)，其中 key_id 为准备该计划的密钥 ID。
  4. posttx 将任务加入队列并扣除服务费；队列会在数秒内发送转账。结果可通过 task/{TASK_ID} 或 task.done Webhook 获取。
字段说明
to收款方：address 和 amount；tag 为目标标签，comment 为给收款方的文本，最多 120 个字符，仅限支持的网络。多个收款方（最多 100 个）仅限带 multi_recipient 的组合；使用 send_all 时只能有一个不带 amount 的收款方。
from您的来源地址（address）；不填时自动选择。在账户模型网络中只能一个地址。
order来源选择顺序：desc（默认）先用大额地址，asc 先用小额地址。
feepreparetx：fast、normal（默认）或 low；在 UTXO 网络中还可以是以 fee_rate_unit 为单位的费率数值。账户模型网络仅支持 normal；需要支付能量的代币还可选 rent 或 burn。
changepreparetx，UTXO 网络：找零去向——auto（默认，最大一笔输入的地址）、new（新地址）或该网络中您自己的地址。
send_allpreparetx：true 表示将来源中的全部资金扣除手续费后发出。

getfee 与 spendinfo

getfee 使用相同的 to、from、order。fee_coin 为网络手续费的币种（代币则为网络原生币）；fast、normal、low 为 amount 及五种货币，若网络没有该档位或在该档位下金额加手续费不够则为 null（所有档位都不够时返回 409 A018）；service_fee_usd 为服务费；extra 为额外费用。

{
    "coin": "DOGE",
    "network": "dogecoin-mainnet",
    "fee_coin": "DOGE",
    "fast": {
        "amount": "0.04452",
        "usd": "0.2",
        "eur": "0.01",
        "rub": "0.5",
        "cny": "0.04",
        "inr": "0.47"
    },
    "normal": {
        "amount": "0.02226",
        "usd": "0.1",
        "eur": "0.01",
        "rub": "0.5",
        "cny": "0.04",
        "inr": "0.47"
    },
    "low": null,
    "service_fee_usd": "0.10",
    "extra": []
}
extra.type含义
gas代币地址上的网络原生币不足：amount 将从您的另一个地址转入，network_fee 为该笔转账的手续费。
rent不带 provider：在收款方尚无代币账户时为其创建账户。
burn, rent带 provider：支付代币能量的方式——燃烧（burn）或租用（rent）；selected 标出 fee normal 会选择的方式。

spendinfo 使用 to 和 order。sources 为按 order 排序的有资金地址：address、balance（可用）、locked（被未完成转账占用）、use（发送时将从该地址取用的金额）；enough 表示是否足够。代币的 use 为代币金额，手续费由 getfee 和 preparetx 检查。

preparetx：发送计划

请求：network、to、from、order、fee、change、send_all。响应为计划以及用于在 posttx 中确认的数据。支付余额不足以支付服务费时返回 409 A020。

{
    "prepare_id": "prep_9a3f0c7d21b84e65f0a1c2d3",
    "prepare_confirm": "5c0e8d1f7a2b4c6d9e3f1a0b2c4d6e8f",
    "prepare_time": 1789647000,
    "expires_at": "2026-09-17T12:15:00Z",
    "fingerprint": "0995342725a2b11aa2260e7e84e6394754eef9dcc7412a222e2952b9d9589345",
    "coin": "DOGE",
    "network": "dogecoin-mainnet",
    "tx": {
        "sources": [
            {
                "address": "DLp4hPWtqM8sQZoyk2vRj3TfGcX5nA7bUe",
                "amount": "150.5"
            }
        ],
        "recipients": [
            {
                "address": "D8vFz4p1L37jdg47HXKtSHA5uYLYxbGgPD",
                "amount": "100"
            }
        ],
        "change": {
            "address": "DLp4hPWtqM8sQZoyk2vRj3TfGcX5nA7bUe",
            "amount": "50.47774"
        },
        "network_fee": "0.02226",
        "fee_coin": "DOGE",
        "fee_rate": "100",
        "fee_rate_unit": "koinu/vB",
        "size": 226,
        "replaceable": false
    },
    "steps": [
        {
            "type": "send"
        }
    ],
    "service_fee_usd": "0.10"
}
字段说明
tx.sources来源地址以及每个地址转出的金额（含网络手续费）。
tx.recipients收款方及金额；在使用标签或备注的网络中包含 tag 和 comment。
tx.changeUTXO 找零：地址和金额；无找零时为 null。
tx.network_fee, tx.fee_coin网络手续费及其币种。
tx.fee_rate, tx.fee_rate_unit, tx.size, tx.replaceableUTXO 网络：费率及其单位、交易大小，以及能否被更高手续费的交易替换。
tx.fee_payer, tx.rent由您的另一个地址在同一笔交易中支付手续费的代币：该地址以及为收款方创建账户的费用。
steps执行步骤：gas 为先补充燃料（from、to、amount、network_fee），rent 为租用能量（provider、energy、cost），send 为转账本身。
expires_at, fingerprint计划有效期及其指纹：只能在 expires_at 之前确认计划。

posttx 与任务

posttx 传入 prepare_id 和 confirm，返回任务对象。使用相同 prepare_id 重复调用会返回同一任务，计划过期后亦然，因此连接中断后可以安全重试。他人的计划返回 404 A021，已过期返回 409 A021，confirm 错误返回 400 A002。task/{TASK_ID} 返回同样的对象。

{
    "task_id": "task_6f1c2a9b0d4e8f7a3c5b1d20",
    "task_info": "confirmed",
    "task_start": "2026-09-17T12:10:00Z",
    "task_sent": "2026-09-17T12:10:04Z",
    "task_done": "2026-09-17T12:20:12Z",
    "prepare_id": "prep_9a3f0c7d21b84e65f0a1c2d3",
    "coin": "DOGE",
    "network": "dogecoin-mainnet",
    "txid": "b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7b7",
    "gas_txid": null,
    "confirmations": 6,
    "error_code": null,
    "tx": {
        "sources": [
            {
                "address": "DLp4hPWtqM8sQZoyk2vRj3TfGcX5nA7bUe",
                "amount": "150.5"
            }
        ],
        "recipients": [
            {
                "address": "D8vFz4p1L37jdg47HXKtSHA5uYLYxbGgPD",
                "amount": "100"
            }
        ],
        "change": {
            "address": "DLp4hPWtqM8sQZoyk2vRj3TfGcX5nA7bUe",
            "amount": "50.47774"
        },
        "network_fee": "0.02226",
        "fee_coin": "DOGE",
        "fee_rate": "100",
        "fee_rate_unit": "koinu/vB",
        "size": 226,
        "replaceable": false
    },
    "service_fee_usd": "0.1"
}
task_info含义
queue排队中；任务可以取消。
processing正在发送。
gas等待代币燃料补充交易确认。
rent等待能量租用。
sent已上链，等待确认。
unknown发送结果未知：节点未响应。请勿重复转账——对账会确定结果，任务会自行继续。
confirmed已确认。
failed未完成——原因见 error_code。
dropped交易未获确认即从网络中掉落。
cancelled已由客户端取消。
字段说明
task_start, task_sent, task_done入队、上链和到达最终状态的时间；尚未发生时为 null。
txid, gas_txid, confirmations转账交易、燃料补充交易及确认数；发送前为 null。
error_code任务未完成时的原因代码，否则为 null。
tx, service_fee_usd来自 preparetx 的计划及该任务扣除的服务费。
error_code含义
A009网络或节点不可用超过 30 分钟，或发送结果未知。
A018发送时地址上的资金不足。
A021计划已过时（preparetx 之后余额、手续费或地址发生变化）或账户被冻结。
A023网络拒绝了交易；已扣除网络手续费。
A025能量租用失败。

task/{TASK_ID}/cancel 取消处于 queue 的任务——在首次尝试之前或两次重试之间；已发送燃料或已下单租用后无法取消。之后调用返回 409 A024。对已取消的任务重复调用会返回该任务。

各网络特点

  • UTXO 网络：支持多个收款方，fast、normal、low 档位或自定义费率，找零通过 change 指定；来源为您地址上的输入。
  • 账户模型网络：一个来源地址和一个收款方，仅 normal。有未完成转账的地址在其确认前处于占用状态——任务最多等待 30 分钟。
  • 使用目标标签的网络（assets 中的 tag）：to[].tag 会传给收款方；转入您地址的入账通过 transfers 中的 tag 区分，getnewaddress 会为同一地址发放新标签。
  • 支持转账备注的网络：to[].comment 为最多 120 个字符的文本；其他网络会拒绝该字段（400 A002）。
  • 代币：手续费以网络原生币从同一地址支付。若不足，计划以 gas 步骤开始：从您在该网络中最大的空闲地址补充，补充确认后再发送代币。
  • 需要支付能量的代币：fee normal 会向最便宜的已连接服务商租用，否则燃烧；rent 或 burn 为手动选择。租用失败——failed A025。服务商在账户设置的“助手”标签页中连接。
  • 由您网络原生币余额最多的地址在同一笔交易中支付手续费和收款方账户创建费用的代币：tx 中包含 fee_payer 和 rent，没有 gas 步骤。
  • 隐私网络：从一个地址发送，getfee 为上限估算，准确手续费见 preparetx，不提供 privkey；通过节点钱包发送最多需要几分钟。

服务费与支付余额

服务费按套餐计算：按 USD 金额的百分比，设有最低和最高值；getfee 和 preparetx 会显示（service_fee_usd）。在 posttx 时从支付余额中扣除；若转账未上链、掉落或任务被取消则退还。已确认的转账以及被网络拒绝的转账（failed A023）不退还。

为避免因余额不足导致发送停滞，请在个人中心开启自动充值（支付余额 → 自动充值）；余额低于阈值时 paybalance.low Webhook 会提醒您。

相关文档

全部文档