> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 交易

> 查询、监控和管理钱包中的所有链上活动

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

## 前提条件

<Steps>
  <Step title="API 密钥">
    从 [Blockradar 控制台](https://dashboard.blockradar.co) 获取您的 API 密钥。前往**开发者**页面生成一个。
  </Step>

  <Step title="已创建钱包">
    您需要 `walletId` 来查询交易记录。
  </Step>
</Steps>

## 工作原理

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

<CardGroup cols={2}>
  <Card title="查询历史记录" icon="clock-rotate-left">
    检索钱包的所有交易，或按地址、资产、状态或日期范围进行筛选。
  </Card>

  <Card title="调查付款" icon="magnifying-glass">
    按 ID 查找特定交易，检查其状态、哈希和元数据。
  </Card>

  <Card title="重发 Webhook" icon="rotate">
    为系统可能遗漏或处理失败的交易重新发送 webhook。
  </Card>

  <Card title="取消或重试" icon="arrow-rotate-left">
    取消卡住的待处理交易，或重试失败的交易，无需重新提交。
  </Card>
</CardGroup>

## 交易状态

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

## 查询交易

```bash theme={null}
GET /v1/wallets/{walletId}/transactions
GET /v1/wallets/{walletId}/transactions/{transactionId}
```

## 重发丢失的 Webhook

```bash theme={null}
POST /v1/wallets/{walletId}/transactions/{transactionId}/resend-webhook
```

## 取消待处理交易

```bash theme={null}
POST /v1/wallets/{walletId}/transactions/{transactionId}/cancel
```

<Warning>
  取消操作仅在交易广播到区块链之前有效。
</Warning>

## 重试失败的交易

```bash theme={null}
POST /v1/wallets/{walletId}/transactions/{transactionId}/retry
```

## 最佳实践

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

## API 参考

| 端点                                                          | 描述          |
| ----------------------------------------------------------- | ----------- |
| [获取交易列表](/en/api-reference/transactions/get-transactions)   | 查询钱包的所有交易   |
| [获取单笔交易](/en/api-reference/transactions/get-transaction)    | 按 ID 查询单笔交易 |
| [重发 Webhook](/en/api-reference/transactions/resend-webhook) | 重发 webhook  |
| [取消交易](/en/api-reference/transactions/cancel-transaction)   | 取消待处理交易     |
| [重试交易](/en/api-reference/transactions/retry-transaction)    | 重试失败的交易     |