交易 - Blockradar

简而言之
每一笔流经 Blockradar 的存款、提款、兑换或归集操作都会生成一条交易记录。交易 API 是您的活动日志——用它来查询历史记录、调查特定付款、重发丢失的 webhook、取消待处理交易或重试失败的交易。

前提条件

API 密钥

从 Blockradar 控制台获取您的 API 密钥。前往开发者页面生成一个。

已创建钱包

您需要 walletId 来查询交易记录。请在控制台中创建钱包（参见创建主钱包）。

工作原理

当 Blockradar 钱包发生任何链上事件时——存款到账、提款提交、归集触发——Blockradar 会创建一条交易记录并触发 webhook。交易 API 为您提供对所有这些记录的编程访问。

查询历史记录

检索钱包的所有交易，或按地址、资产、状态或日期范围进行筛选。

调查付款

按 ID 查找特定交易，检查其状态、哈希和元数据。

重发 Webhook

为系统可能遗漏或处理失败的交易重新发送 webhook。

取消或重试

取消卡住的待处理交易，或重试失败的交易，无需重新提交。

交易状态

状态	描述
`PENDING`	交易已提交至区块链，等待确认
`SUCCESS`	交易已确认并结算
`FAILED`	交易在链上失败或被拒绝
`CANCELLED`	交易在广播前已被取消

查询交易

获取钱包的所有交易

GET /v1/wallets/{walletId}/transactions

您可以使用查询参数按地址、资产、类型、状态和日期范围进行筛选。

获取单笔交易

GET /v1/wallets/{walletId}/transactions/{transactionId}

示例

const transactions = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/transactions?status=SUCCESS&limit=50`,
  {
    headers: { 'x-api-key': apiKey }
  }
).then(r => r.json());

console.log(transactions.data);

重发丢失的 Webhook

如果您的系统遗漏了某个 webhook 或处理失败，您可以触发重发，而无需等待下一个链上事件。

POST /v1/wallets/{walletId}/transactions/{transactionId}/resend-webhook

这对于对账流程和从宕机中恢复非常有用。

取消待处理交易

如果交易卡在 PENDING 状态且尚未广播，您可以将其取消。

POST /v1/wallets/{walletId}/transactions/{transactionId}/cancel

取消操作仅在交易广播到区块链之前有效。交易一旦上链，便无法取消。

重试失败的交易

如果交易因 Gas 不足或临时节点问题而失败，您可以重试。

POST /v1/wallets/{walletId}/transactions/{transactionId}/retry

最佳实践

以 webhook 作为主要信号——不要轮询交易 API 获取实时更新，而是将其用于对账、调查和查询历史记录。
存储交易 ID——将 Blockradar 交易 ID 与您的内部记录一同保存，以便随时查询状态。
宕机后重发 webhook——如果您的 webhook 端点曾不可用，请使用重发端点恢复丢失的事件，而不是手动重新处理。

API 参考

端点	描述
获取交易列表	查询钱包的所有交易
获取单笔交易	按 ID 查询单笔交易
重发 Webhook	为交易重发 webhook
触发资产归集	手动触发归集
取消交易	取消待处理交易
重试交易	重试失败的交易

开始使用

钱包

收款

付款

转换与管理

合规与工具

交易

前提条件

工作原理

查询历史记录

调查付款

重发 Webhook

取消或重试

交易状态

查询交易

获取钱包的所有交易

获取单笔交易

示例

重发丢失的 Webhook

取消待处理交易

重试失败的交易

最佳实践

API 参考

​前提条件

​工作原理

查询历史记录

调查付款

重发 Webhook

取消或重试

​交易状态

​查询交易

​获取钱包的所有交易

​获取单笔交易

​示例

​重发丢失的 Webhook

​取消待处理交易

​重试失败的交易

​最佳实践

​API 参考

前提条件

工作原理

交易状态

查询交易

获取钱包的所有交易

获取单笔交易

示例

重发丢失的 Webhook

取消待处理交易

重试失败的交易

最佳实践

API 参考