跳转到主要内容

​
充值与 Webhook

这通常是临时索引延迟。使用充值查找器手动触发索引：
  • 控制台： 前往主钱包 → 概览 → 点击”充值查找器”
  • API： POST /v1/wallets/{walletId}/rescan/blocks，附带 transactionHash
充值查找器文档 →
Webhook 延迟可能由以下原因引起：区块链网络拥堵、节点索引临时延迟，或您的 Webhook 端点返回错误。查看 Webhook 日志：
  • 控制台： 主钱包 → 开发者 → Webhook 日志
  • API： GET /v1/wallets/{walletId}/webhooks

​
自动归集

默认情况下，disableAutoSweep 设为 false，即自动归集已启用。当子地址收到充值时，资金会自动归集至主钱包。如需将资金保留在子地址：
  • 通过 API 创建地址时设置 disableAutoSweep: true
  • 或在控制台的地址设置中切换禁用自动归集
请检查两个配置层级。地址级别设置始终优先。
  • 主钱包级别 — 为所有地址设置默认值
  • 地址级别 — 覆盖主钱包设置
请确认该特定地址已设置 disableAutoSweep: true。
可以。您可以配置归集阈值，使资金仅在达到一定余额后才自动归集。钱包配置 →

​
Gas 费用与网络成本

Gas 费用以原生代币直接支付给区块链：
链原生代币
Ethereum / Base / Polygon 等ETH
TronTRX
SolanaSOL
Blockradar 不在网络成本之上收取额外费用。
由于 Tron 处理带宽和能量的方式，Tron 网络费用通常为每笔交易 1–6 美元。这是区块链层面的成本，并非 Blockradar 的收费。低成本替代方案：
  • Solana： 每笔交易约 0.01–0.30 美元
  • Base： 每笔交易约 0.01–0.10 美元
  • Polygon： 每笔交易约 0.01–0.10 美元
/withdraw/network-fee 端点返回保守估算值，以确保即使在网络拥堵期间交易也能成功。您仅需支付实际网络费用，通常低于估算值。
不能，区块链 Gas 费用必须以该链的原生代币支付。但您可以启用无 Gas 提款，让主钱包为子地址交易承担 Gas 费用。

​
无 Gas 交易

启用无 Gas 模式后，主钱包将代替子地址支付 Gas 费用。启用方式：
  • 主钱包级别： 控制台 → 主钱包设置 → 启用无 Gas 交易
  • 地址级别： 创建或更新地址时设置 enableGaslessWithdraw: true
无 Gas 交易 → · 地址参数 →
取决于 enableGaslessWithdraw 设置：
  • 已启用（true）： 主钱包支付 Gas
  • 已禁用（false，默认值）： 子地址需要自己的 Gas

​
兑换与跨链桥

Blockradar 仅支持稳定币之间的兑换：USDT、USDC、DAI、BUSD、cUSD、cNGN、EURC、IDRX。不支持原生代币兑换（如 USDT → TRX、USDC → ETH）。
这通常意味着该兑换对不受支持，或金额对于可用流动性而言过小或过大。
此错误通常意味着您使用了错误的资产 ID。请使用钱包专属资产 ID，而非通用资产 ID。
  • 控制台： 前往您的钱包 → 资产 → 从那里复制资产 ID
  • API： 使用钱包详情端点返回的资产 ID
可以。您可以通过控制台或 API 在不同区块链之间兑换和转移资产。通过 API 进行跨链兑换时，请将目标主钱包的资产 ID 作为 toAssetId 传入。兑换文档 →

​
钱包设置与配置

  • EVM 链（Ethereum、Base、Polygon、Arbitrum、Optimism 等）：1 个钱包覆盖所有
  • Tron（TRC20）： 需要单独的钱包
  • Solana： 需要单独的钱包
不能。由于区块链限制，地址无法删除。您只能在控制台中停用它们。停用的地址不会接收新充值，也不会被监控。
通过 API 获取钱包或地址详情时使用 showPrivateKey: true 参数。
仅在安全可信的环境中使用此功能。

​
提款与转账

使用提款 API 端点：POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw提款文档 →
常见原因：
  • 主钱包（使用无 Gas 模式时）或子地址中 Gas 不足
  • 队列处理 — 由于区块链 nonce，交易按顺序处理
  • 节点问题 — 临时延迟
如果卡住超过 30 分钟，请联系支持并提供交易 ID。
所有链上资金转移均使用提款端点，没有单独的”转账”端点。
  • 主到子： POST /v1/wallets/{walletId}/withdraw，以子地址为目标
  • 子到主： POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw，以主钱包地址为目标
  • 子到外部： 相同端点，以外部地址为目标
提款文档 →
使用带有地址查询参数的交易端点：
GET /v1/wallets/{walletId}/transactions?address={addressId}
交易文档 →

​
资产恢复

在控制台中使用资产恢复功能。目前仅支持主钱包。资产恢复 →
Blockradar 在设计上仅索引稳定币。原生代币充值（ETH、TRX、SOL 等）不会显示在控制台的交易历史中。但资金仍在您的钱包中，可以在区块链浏览器上查看，或通过 API 或控制台提取。

​
测试网与主网

不，您的资金没有丢失。地址在加密层面是相互关联的。您可以使用资产恢复功能找回资金。资产恢复 →
进行交易前，请务必检查控制台中的环境指示器（显示”Testnet”或”Live”）。
  1. 使用控制台中的环境切换器（通常在右上角或钱包设置中）
  2. 从测试网切换到Live
  3. 为主网创建新的主钱包
  4. 更新您的 API 密钥 — 测试网密钥在主网上无效
测试网地址无法接收主网资金，反之亦然。
链水龙头
Ethereum (Sepolia)Sepolia Faucet
BNB ChainBNB 测试网水龙头
Polygon (Amoy)Polygon 水龙头
BaseAlchemy 水龙头
Tron (Nile)Nile 测试网
SolanaSolana 水龙头
Circle USDCCircle 水龙头

​
API 错误与故障排除

常见原因：
  • 钱包 ID 错误
  • API 密钥错误（与钱包不匹配）
  • 使用了通用资产 ID 而非钱包专属资产 ID
通常是临时问题。如果持续出现，请联系支持，提供您调用的端点、区块链/网络以及完整错误响应。
您的 API 密钥无效或与钱包不匹配。请检查：
  • API 密钥正确（无多余空格）
  • API 密钥属于此钱包
  • 未在主网上使用测试网密钥（反之亦然）
  • API 密钥未被轮换或重新生成
资源不存在或您使用了错误的 ID。常见原因：钱包或地址 ID 错误、使用通用资产 ID 而非钱包专属 ID，或端点 URL 中存在拼写错误。

​
虚拟账户与 cNGN

虚拟账户允许您的用户充值 NGN（尼日利亚奈拉），并自动转换为链上稳定币。要求：
  • 必须处于主网/Live 模式（非测试网）
  • 必须完成 KYB 验证
虚拟账户文档 →
虚拟账户仅在以下情况显示：处于 Live 模式、账户已完成 KYB 验证，且该功能已为您的账户启用。
cNGN 是与尼日利亚奈拉挂钩的稳定币。Blockradar 支持 cNGN 交易及其与其他稳定币的兑换。

​
法币出入金

使用 NGN 虚拟账户：
  1. 为用户生成虚拟账户
  2. 用户通过银行转账充值 NGN
  3. 资金自动转换为稳定币并显示在链上
虚拟账户文档 →
目前，虚拟账户仅支持 NGN。对于其他货币，您需要接入第三方法币出入金服务商。

​
功能请求

不支持。Blockradar 专注于稳定币，目前不支持比特币。
Blockradar 对区块链和稳定币保持中立 — 可根据需求接入更多网络和资产。联系我们 讨论您的需求。

​
计费与订阅

可以。您可以通过发送至您邮箱的付款链接支付，或从主钱包提款至付款链接地址。
目前，我们仅支持使用稳定币支付订阅费。

​
支持的区块链与资产

Ethereum、BNB Chain、Polygon、Tron、Base、Arbitrum、Optimism、Solana、Celo、Lisk、Avalanche、Asset Chain、Plasma。Blockradar 对区块链和稳定币保持中立 — 可根据需求接入更多网络。
USDT、USDC、DAI、BUSD、cUSD、cNGN、EURC、IDRX。可根据需求接入更多资产。

​
开发者建议

  • 钱包 ID： 标识您的主钱包
  • 地址 ID： 标识钱包内的特定子地址
  • 资产 ID： 标识钱包内的特定资产（USDT、USDC 等）
请始终使用来自钱包资产列表的钱包专属资产 ID，而非通用资产 ID。
  • 始终使用主网/Live 模式进行真实交易
  • 将钱包 ID 和地址 ID 存储在您的数据库中
  • 实现 Webhook 处理器以获取实时交易更新
  • 使用充值查找器作为遗漏交易的备用方案
  • 监控主钱包的 Gas 余额（原生代币）
  • 如果您的用户不应需要持有原生代币，请启用无 Gas 提款

​
需要帮助？

文档

docs.blockradar.co

控制台

dashboard.blockradar.co

预约支持通话

点击预约