Skip to main content

​
存款与 Webhooks

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

​
自动归集

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

​
Gas 费用与网络成本

Gas 费用以链的原生代币直接支付给区块链——例如 Ethereum、Base、Arbitrum 和 Optimism 上的 ETH，BNB Chain 上的 BNB，Polygon 上的 POL（原 MATIC），Tron 上的 TRX，Solana 上的 SOL，以及 Stellar 上的 XLM。Blockradar 不会对网络 Gas 加价：您只需支付区块链收取的费用。其他产品可能有各自的收费——请参阅下方的“费用与定价”。
由于 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。

​
地址激活（Stellar、Tron、Solana）

部分区块链要求地址先完成激活或注资，才能持有代币。这是网络规则，不是 Blockradar 的收费，您的钱包也没有被盗取：地址激活 →
使用 enableIndexing: false 将地址签发为休眠地址。激活会推迟到您对其开启索引时才进行，因此您只需为客户实际使用的地址注资储备金。
最常见的原因是主钱包余额不足。请为您的 Stellar 主钱包充值 XLM——资金到账后，待处理的激活会自动重试。查看该地址上的 configurations.stellar.lastError 以了解具体原因。

​
无 Gas 交易

启用无 Gas 后，主钱包代替子地址支付提现的 Gas 费用。启用方式：
  • 主钱包级别： 控制台 → 主钱包设置 → 启用无 Gas 交易
  • 地址级别： 创建或更新地址时设置 enableGaslessWithdraw: true
您还可以设置阈值，仅覆盖高于或低于特定金额的提现。无 Gas 交易 → · 地址参数 →
取决于 enableGaslessWithdraw 设置：
  • 启用（true）： 主钱包支付 Gas
  • 禁用（false，默认）： 子地址需要自己的 Gas

​
兑换与桥接

Blockradar 支持稳定币之间的兑换（例如 USDT ↔ USDC），以及稳定币与原生代币之间的兑换（例如 SOL → USDC 或 USDC → TRX），同链和跨链均可。流动性因交易对、链和金额而异，因此在向用户提供某条路径之前，请先请求报价进行确认。兑换文档 →
常见原因：
  • 该交易对在该链上目前没有可用的路径或流动性
  • 金额对于可用流动性来说太小或太大
  • 该资产未在您的钱包中启用
请尝试其他金额，或检查相关钱包上是否已启用这两种资产。
此错误通常意味着您使用了错误的资产 ID。您需要使用钱包特定的资产 ID，而不是通用资产 ID。查找正确 ID 的方法：
  • 控制台： 前往您的钱包 → 资产 → 从那里复制资产 ID
  • API： 使用钱包详情端点返回的资产 ID
可以。您可以通过控制台或 API 跨不同区块链兑换和桥接资产。通过 API 进行跨链兑换时，将目标主钱包的资产 ID 作为 toAssetId 传递。兑换文档 →

​
钱包设置与配置

是的。每个区块链网络都需要自己的主钱包，每条 EVM 链也不例外——Base 钱包并不涵盖 Ethereum、Polygon 或 Arbitrum。请为您要支持的每条链各创建一个主钱包。创建主钱包 →
Blockradar 每个账户每条区块链网络仅允许一个主钱包。要支持额外的区块链，您必须为其创建单独的主钱包。在单个主钱包内，您可以根据需要创建任意数量的子地址，按用户、应用或用途划分资金。不支持为同一区块链创建多个主钱包。
不可以，由于区块链的限制，地址无法删除。您只能在控制台中停用它们。停用的地址不会接收新的存款或被监控。
可以。地址白名单允许您将外部地址添加到钱包中，由 Blockradar 监控其存款，而无需更改您现有的设置。地址白名单 →
通过 API 获取钱包或地址详情时使用 showPrivateKey: true 参数。
仅在安全、可信的环境中使用此功能。

​
提现与转账

使用提现 API 端点：POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw提现文档 →
常见原因：
  • 主钱包（如果使用无 Gas）或子地址中的 Gas 不足
  • 队列处理——由于区块链 nonce，交易按顺序处理
  • 节点问题——临时延迟
如果超过 30 分钟仍处于待处理状态，请携带交易 ID 联系支持团队。
可以：
可以。仅签名模式会对交易进行签名并将其返回，而不提交到区块链——适用于离线签名、多重签名工作流，或在广播前检查交易。
  • 主钱包： POST /v1/wallets/{walletId}/withdraw/sign
  • 子地址： POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/sign
仅签名模式 →
所有链上资金转移都使用提现端点。没有单独的”转账”端点。
  • 主钱包到子地址： POST /v1/wallets/{walletId}/withdraw，子地址作为目标
  • 子地址到主钱包： POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw，主钱包地址作为目标
  • 子地址到外部： 相同端点，外部地址作为目标
提现文档 →
使用带有地址查询参数的交易端点：
交易文档 →

​
资产找回

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

​
测试模式与正式模式

不会，您的资金没有丢失。主网和测试网是独立的网络，但地址在密码学上是关联的。您可以使用资产找回来恢复资金。资产找回 →
交易前请始终检查控制台中的环境指示器（显示”Test Mode”或”Live Mode”）。
  1. 使用控制台中的环境切换按钮（通常在右上角或钱包设置中）
  2. 从 Test Mode 切换到 Live Mode
  3. 为主网创建新的主钱包
  4. 更新您的 API 密钥——Test Mode 密钥在 Live Mode 下无法使用
测试网地址无法接收主网资金，反之亦然。
用于支付 Gas 的原生代币：大多数链上的测试网 USDC 和 EURC，请使用 Circle Faucet。所有链的稳定币水龙头都列在支持的资产页面上。

​
API 错误与故障排除

常见原因：
  • 错误的钱包 ID
  • 错误的 API 密钥（与钱包不匹配）
  • 使用通用资产 ID 而非钱包特定的资产 ID
通常是临时问题。如果持续出现，请携带您调用的端点、区块链/网络以及完整的错误响应联系支持团队。
您的 API 密钥无效或与您尝试访问的钱包不匹配。请检查：
  • API 密钥是否正确（没有多余的空格）
  • API 密钥是否属于此钱包
  • 是否在 Live Mode 下使用了 Test Mode 密钥（或反之）
  • API 密钥是否已被轮换或重新生成
资源（钱包、地址或资产）不存在或您使用了错误的 ID。常见原因包括错误的钱包 ID 或地址 ID、使用通用资产 ID 而非钱包特定的 ID，或端点 URL 中的拼写错误。
您已超出 API 速率限制。请降低请求频率，稍等片刻后重试，最好采用指数退避。避免在紧密循环中轮询——使用 Webhook 获取交易更新，并缓存发现类端点（支持的资产、货币、区块链）的响应，而不是在每次请求时都调用它们。错误 →

​
费用与定价

Gas 方面不会——Blockradar 按原价转付网络费用，不加价。部分产品有各自的收费：
  • 兑换和法币转换可能在汇率上包含加价
  • 法币存入和出金可能收取处理费
  • 创建虚拟账户可能收取固定费用
  • Earn 在您提取时从收益中扣除费用，绝不从您的本金中扣除
费率取决于您的套餐和商务条款。报价端点会在您执行某笔交易之前显示该交易的汇率和费用。如需了解您账户的定价，请联系 [email protected]。

​
虚拟账户与法币存入

  • 合规审批： 在控制台的 My Wallets → Settings → Compliance 下完成尽职调查流程
  • 功能激活： 合规审批通过后，通过 [email protected] 或控制台上的在线聊天申请激活虚拟账户
  • 包含稳定币功能的付费套餐： 存入法币并将其转换为稳定币是付费功能。请在 Dashboard → Settings → Subscription 中升级
  • 正确的环境： Test Mode 请求仅使用测试网路径和钱包；Live Mode 请求仅使用主网路径和钱包
虚拟账户文档 →
虚拟账户仅在以下条件全部满足时显示：您的合规审批已通过、该功能已为您的账户激活，并且您的套餐包含稳定币功能。
  • **可重复使用的虚拟账户**是与主钱包或子地址关联的长期银行账户。每笔存入的资金都会转换为稳定币——适合客户的定期存款。
  • **法币存入支付订单**会为单笔预期付款创建一个一次性虚拟账户。该账户仅对这一笔付款有效。
目前已开放存入的法币有 ARS、BRL、COP、EUR、KES、MXN 和 USD。
NGN 虚拟账户目前处于停用状态。通过法币提现进行的 NGN 出金不受影响。
可用性因通道和钱包而异，因此在向用户展示某个选项之前，请先检查您的钱包支持哪些内容：可重复使用的账户请使用虚拟账户发现端点，法币存入请使用 Get Supported Currencies。
不可以。AUD、CAD、GHS、THB、TRY、TZS、UGX、XOF 和 ZAR 仅支持出金：您可以通过法币提现向这些货币出金，但用户无法存入这些货币。
cNGN 是一种与尼日利亚奈拉挂钩的稳定币。Blockradar 支持 cNGN 交易以及与其他稳定币的兑换。

​
法币出金（法币提现）

使用法币提现。它将受支持的稳定币转换为法币，并从主钱包或子地址出金到银行账户、移动支付及其他本地通道。该流程会发现某个通道可用的支付方式，准确告诉您每种方式需要哪些收款人信息，然后进行报价并执行出金。
目前已开放出金的货币有 ARS、AUD、BRL、CAD、COP、EUR、GHS、KES、MXN、NGN、THB、TRY、TZS、UGX、USD、XOF 和 ZAR。可用性因通道和钱包而异，因此请通过 Get Supported Currencies 获取实时列表，而不是将其硬编码。

​
Earn

Earn 让您将闲置的稳定币投入计息的 DeFi 协议（Aave 和 Compound）中产生收益。它是非托管的：资金从您自己的钱包转出，Blockradar 从不汇集或持有这些资金，也没有锁定期。Earn →
Aave 可在 Ethereum、Base、Arbitrum、Optimism、Polygon 和 BNB Smart Chain 上使用。Compound 可在 Ethereum、Base 和 Arbitrum 上使用。控制台仅显示您的钱包可使用 Earn 的网络。
存入免费。提取时，您会准确收到您申请的金额——费用从您的收益中扣除，绝不从本金中扣除。您可以随时提取部分或全部仓位。利率是浮动的，且 DeFi 存在智能合约风险，因此收益无法保证。

​
合规与安全

可以。AML API 会将任意钱包地址与 OFAC、FBI、Tether 和 Circle 的黑名单进行比对筛查，让您在发送或接收资金之前标记高风险交易对手。AML 筛查 →
可以。IP 白名单将 API 请求限制在您允许的 IP 地址范围内，为您的集成再增加一层保护。IP 白名单 →
部分法币通道要求您的客户完成验证。使用 Customer API 创建客户，然后通过客户入驻请求提交他们的信息和文件。仅收集要求 schema 中要求的字段——请参阅动态表单。

​
其他产品

可以。稳定币结账让您通过可分享的链接接收稳定币付款——无需客户账户或复杂的集成。
可以。Gateway 为您提供统一的、链抽象的 USDC 余额：从任意支持的链存入，并提取到任意支持的链，无需手动跨链桥接。
可以。自动结算会根据您一次性定义的规则，将传入的存款转换为您偏好的资产，并路由到您的目标链。
Liquidity Pool 允许已审核通过的 Liquidity Provider 为资产对设置汇率。这些汇率为 Blockradar 的兑换引擎提供支持，该引擎会从活跃的提供者中选择最佳可用汇率。
可以。Smart Contract API 让您直接从钱包读取和写入任意智能合约，无需自行管理 RPC 端点或签名流程。

​
功能请求

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

​
计费与订阅

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

​
支持的区块链与资产

Ethereum、BNB Chain、Polygon、Tron、Base、Arbitrum、Optimism、Solana、Stellar、Celo、Lisk、Avalanche、Asset Chain、Arc、Plasma 和 TempoBlockradar 与区块链和稳定币无关——可根据请求集成其他网络。支持的区块链 →
USDT、USDC、DAI、BUSD、cUSD、cNGN、EURC、IDRX、ZARP、JPYC、MXNB、PYUSD、AlphaUSD、OUSD可根据请求集成其他资产。支持的资产 →

​
开发者提示

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

​
需要帮助？

文档

docs.blockradar.co

控制台

dashboard.blockradar.co

预约支持电话

在此预约