跳转到主要内容

​
存款与 Webhooks

这通常是临时的索引延迟。使用存款查找器手动触发索引：
  • 控制台： 前往主钱包 → 概览 → 点击”Deposit Finder”
  • API： 使用 transactionHash 调用 POST /v1/wallets/{walletId}/rescan/blocks
存款查找器文档 →
Webhook 延迟可能由区块链网络拥堵、临时节点索引延迟或您的 Webhook 端点返回错误导致。检查 Webhook 日志：
  • 控制台： 主钱包 → 开发者 → Webhook 日志
  • API： GET /v1/wallets/{walletId}/webhooks
Blockradar 设计上仅索引稳定币。原生代币存款（ETH、TRX、SOL 等）不会出现在控制台的交易历史中。但资金仍在您的钱包中，可以在区块链浏览器上查看或通过 API 或控制台提现。

​
自动归集

默认情况下，disableAutoSweep 设置为 false，即自动归集已启用。当存款到达子地址时，会自动归集到您的主钱包。要将资金保留在子地址中：
  • 通过 API 创建地址时设置 disableAutoSweep: true
  • 或在控制台的地址设置中切换 Disable Auto Sweep
检查两个配置级别：
  • 主钱包级别 — 为所有地址设置默认值
  • 地址级别 — 覆盖主钱包设置
地址级别的设置始终优先。请验证特定地址是否已设置 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、JPYC。原生代币兑换和桥接在所有支持的链上均可用，Tron 除外。
这通常意味着不支持该兑换对（例如兑换为原生代币），或金额对于可用流动性来说太小或太大。
此错误通常意味着您使用了错误的资产 ID。您需要使用钱包特定的资产 ID，而不是通用资产 ID。查找正确 ID 的方法：
  • 控制台： 前往您的钱包 → 资产 → 从那里复制资产 ID
  • API： 使用钱包详情端点返回的资产 ID
可以。您可以通过控制台或 API 跨不同区块链兑换和桥接资产。通过 API 进行跨链兑换时，将目标主钱包的资产 ID 作为 toAssetId 传递。兑换文档 →

​
钱包设置与配置

Blockradar 每个账户每条区块链网络仅允许一个主钱包。要支持额外的区块链，您必须为其创建单独的主钱包。在单个主钱包内，您可以根据需要创建任意数量的子地址，按用户、应用或用途划分资金。不支持为同一区块链创建多个主钱包。
不可以，由于区块链的限制，地址无法删除。您只能在控制台中停用它们。停用的地址不会接收新的存款或被监控。
通过 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}
交易文档 →

​
资产找回

在控制台中使用资产找回功能。资产找回 →

​
测试网与主网

不会，您的资金没有丢失。主网和测试网是独立的网络，但地址在密码学上是关联的。您可以使用资产找回来恢复资金。资产找回 →
交易前请始终检查控制台中的环境指示器（显示”Test Mode”或”Live Mode”）。
  1. 使用控制台中的环境切换按钮（通常在右上角或钱包设置中）
  2. 从 Testnet 切换到 Live
  3. 为主网创建新的主钱包
  4. 更新您的 API 密钥 — 测试网密钥在主网上无法使用
测试网地址无法接收主网资金，反之亦然。
链水龙头
Ethereum (Sepolia)Sepolia Faucet 或 Alchemy
BNB ChainBNB Testnet Faucet
Polygon (Amoy)Polygon Faucet
BaseAlchemy Faucet
Tron (Nile)Nile Testnet
SolanaSolana Faucet
Circle USDCCircle Faucet

​
API 错误与故障排除

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

​
虚拟账户与 cNGN

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

​
法币出入金

使用 NGN 虚拟账户：
  1. 为用户生成虚拟账户
  2. 用户通过银行转账或移动支付存入 NGN
  3. 资金自动转换为稳定币并出现在链上
虚拟账户文档 →
目前虚拟账户仅支持 NGN。对于其他货币，您需要集成第三方法币服务提供商，这将允许您将资金提取为 KES、NGN、TZS、UGX、BRL 和 MWK。请参阅提取法币。

​
功能请求

不支持。Blockradar 专注于稳定币。目前不支持比特币。
Blockradar 与区块链和稳定币无关 — 可根据请求集成其他网络和资产。联系我们讨论您的需求。

​
计费与订阅

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

​
支持的区块链与资产

Ethereum、BNB Chain、Polygon、Tron、Base、Arbitrum、Optimism、Solana、Celo、Lisk、Avalanche、Asset Chain、Plasma 和 Tempo。Blockradar 与区块链和稳定币无关 — 可根据请求集成其他网络。
USDT、USDC、DAI、BUSD、cUSD、cNGN、EURC、IDRX、JPYC。可根据请求集成其他资产。

​
开发者提示

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

​
需要帮助？

文档

docs.blockradar.co

控制台

dashboard.blockradar.co

预约支持电话

在此预约