> 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/query.md).

# 查询 KYT 结果

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

查询 KYT 交易检查的处理状态和结构化风险结果。

<mark style="color:green;">`POST`</mark> `/v1/kyt/query`

## 请求 Body

| 名称          | 类型     | 必填 | 说明                                       |
| ----------- | ------ | -- | ---------------------------------------- |
| request\_id | String | 是  | 原交易检查使用的同一个 `request_id`。                |
| order\_no   | String | 否  | 交易检查返回的订单号。如提供，必须与 `request_id` 对应的订单一致。 |

## 请求示例

```json
{
  "request_id": "kyt-tx-202609100001",
  "order_no": "FEE202609100001"
}
```

## 响应 Body

| 名称            | 类型     | 说明                                                                                 |
| ------------- | ------ | ---------------------------------------------------------------------------------- |
| request\_id   | String | 原交易检查使用的请求标识。                                                                      |
| order\_no     | String | 本次检查请求对应的 MusePay 订单号。                                                             |
| status        | Number | 当前[订单状态](/cn/api-can-kao/enums/order-status.md)：`22` 处理中、`44` 失败、`88` 关闭或 `99` 成功。 |
| risk\_level   | String | 筛查服务商返回的风险等级。在分析完成且风险记录可用时返回。                                                      |
| risk\_status  | String | 筛查服务商返回的风险决策。在可用时返回。                                                               |
| result\_data  | Object | 结构化风险指标。在可用时返回。                                                                    |
| created\_time | Number | 风险记录创建时间，为 13 位 Unix 毫秒时间戳。在可用时返回。                                                 |
| updated\_time | Number | 风险记录更新时间，为 13 位 Unix 毫秒时间戳。在可用时返回。                                                 |

### `result_data`

| 名称                                | 类型     | 说明                                             |
| --------------------------------- | ------ | ---------------------------------------------- |
| source                            | String | 本次检查使用的数据源。                                    |
| riskScore                         | Number | 数据源返回的风险评分。                                    |
| riskAmount                        | Number | 识别为风险资金的金额，以 USD 计价。                           |
| orderAmtUSDT                      | Number | 交易金额，以 USDT 计价；如有则返回。                          |
| riskAmountRatio                   | Number | 识别为风险资金的金额占交易金额的比例。                            |
| riskCategoryAmount                | Object | 各风险类别对应的风险金额。Key 为类别名称，Value 为金额。              |
| riskCategoryAmountPercentage      | Object | 各风险类别对应的风险金额占比。                                |
| riskCategoryLevelAmount           | Object | 各风险等级对应的风险金额。Key 可能包括 `HIGH`、`MEDIUM` 和 `LOW`。 |
| riskCategoryLevelAmountPercentage | Object | 各风险等级对应的风险金额占比。                                |
| riskCategoryLevel                 | Object | 各风险类别对应的风险等级。Key 为类别名称，Value 为风险等级。            |

## 处理中响应

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

## 已完成响应

```json
{
  "code": "200",
  "message": "success",
  "data": {
    "request_id": "kyt-tx-202609100001",
    "order_no": "FEE202609100001",
    "status": 99,
    "risk_level": "PASS",
    "risk_status": "APPROVED",
    "result_data": {
      "source": "elliptic",
      "riskScore": 0.0316,
      "riskAmount": 54.10,
      "orderAmtUSDT": null,
      "riskAmountRatio": 0,
      "riskCategoryAmount": {
        "Gambling": 2.05,
        "Dark Service": 2.94
      },
      "riskCategoryAmountPercentage": {},
      "riskCategoryLevelAmount": {
        "HIGH": 50.81,
        "MEDIUM": 3.29
      },
      "riskCategoryLevelAmountPercentage": {},
      "riskCategoryLevel": {
        "Gambling": "MEDIUM",
        "Dark Service": "HIGH"
      }
    },
    "created_time": 1788998400000,
    "updated_time": 1788998401000
  }
}
```

{% hint style="info" %}
风险标签和类别由当前配置的筛查服务商提供。请基于实际返回字段实现您的业务策略，不要依赖固定的标签列表。
{% endhint %}