> For the complete documentation index, see [llms.txt](https://docs.musepay.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.musepay.io/cn/api-can-kao/api-reference/kyt-api/transaction-check.md).

# 交易检查

{% hint style="warning" %}
每个请求都必须包含[通用参数](/cn/api-can-kao/api-reference/common-parameters.md)。
{% endhint %}

提交链上交易进行异步 KYT 风险筛查。

<mark style="color:green;">`POST`</mark> `/v1/kyt/transaction-check`

## 请求 Body

| 名称                   | 类型     | 必填 | 说明                                      |
| -------------------- | ------ | -- | --------------------------------------- |
| request\_id          | String | 是  | 合作伙伴账户内唯一的请求标识。仅在重试同一次检查请求时复用。          |
| chain                | String | 是  | 区块链网络标识，例如 `TRX`。                       |
| currency             | String | 是  | 指定网络上的资产标识，例如 `USDT`。                   |
| txn\_hash            | String | 是  | 交易哈希。长度必须为 8–128 个字符，只能包含字母、数字、下划线或连字符。 |
| destination\_address | String | 否  | 交易目标地址。如提供，必须是有效的区块链地址。                 |

## 请求示例

```json
{
  "request_id": "kyt-tx-202609100001",
  "chain": "TRX",
  "currency": "USDT",
  "txn_hash": "97a17b73d21d7bcc476d6053e7044b21948c49fd65d10f78d38c4536229c80a6",
  "destination_address": "TELGzjHK7bpMN6fHwkvZbVkraDf3C9uTFG"
}
```

## 响应 Body

| 名称           | 类型      | 说明                                                                                                 |
| ------------ | ------- | -------------------------------------------------------------------------------------------------- |
| request\_id  | String  | 合作伙伴提供的请求标识。                                                                                       |
| order\_no    | String  | 本次检查请求对应的 MusePay 订单号，请保存并用于后续结果查询。                                                                |
| status       | Number  | 当前[订单状态](/cn/api-can-kao/enums/order-status.md)。首次响应通常为 `22`（处理中）。                                 |
| risk\_level  | String  | 筛查服务商返回的风险等级。相同 `request_id` 命中已完成的缓存结果时返回。                                                        |
| hit          | Boolean | 是否命中一个或多个风险规则。随已完成结果返回。                                                                            |
| hit\_rules   | Array   | 该交易命中的风险规则。随已完成结果返回。                                                                               |
| actions      | Array   | 风险引擎生成的动作。随已完成结果返回。                                                                                |
| result\_data | Object  | 结构化风险指标。结构与 [`result_data`](/cn/api-can-kao/api-reference/kyt-api/query.md#result_data) 相同，在可用时返回。 |

### `hit_rules`

| 名称             | 类型     | 说明             |
| -------------- | ------ | -------------- |
| rule\_code     | String | 命中的风险规则代码。     |
| decision\_code | String | 规则生成的决策代码。     |
| salience       | Number | 规则优先级或显著性。     |
| result\_data   | Object | 与命中规则相关的服务商数据。 |

### `actions`

| 名称           | 类型     | 说明             |
| ------------ | ------ | -------------- |
| action\_code | String | 风险引擎生成的动作代码。   |
| carry\_param | String | 动作携带的附加参数（如有）。 |

```json
{
  "code": "200",
  "message": "success",
  "data": {
    "request_id": "kyt-tx-202609100001",
    "order_no": "FEE202609100001",
    "status": 22
  }
}
```

{% hint style="info" %}
请轮询[查询 KYT 结果](/cn/api-can-kao/api-reference/kyt-api/query.md)，直到状态变为 `99`（成功）、`44`（失败）或 `88`（关闭）。
{% endhint %}