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

​
前提条件

1

API 密钥

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

已创建钱包

您需要 walletId 来查询交易记录。

​
工作原理

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

查询历史记录

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

调查付款

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

重发 Webhook

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

取消或重试

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

​
交易状态

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

​
查询交易

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

​
重发丢失的 Webhook

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

​
取消待处理交易

POST /v1/wallets/{walletId}/transactions/{transactionId}/cancel
取消操作仅在交易广播到区块链之前有效。

​
重试失败的交易

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

​
最佳实践

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

​
API 参考

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