4、钱包地址风险筛查接口

说明：对钱包地址进行风险筛查。此接口不执行规则引擎配置的策略，也不检测用户在KYT系统配置的私有数据。

1. 接口URL

GET /openapi/v3/risk/address/screening

2. 请求参数

参数名	数据类型	是否必传	描述
apikey	string	true	apikey
chain	string	true	主链
address	string	true	钱包地址

3. 返回参数

{
    "code": 200,
    "message": "success",
    "data": {
        "unique_id": "0140......8be5", 
        "tcr_score": 41, 
        "risk_level": "severe", 
        "risk_types": [ //风险类型
            "Stolen Crypto"
        ],
        "risk_tags":[ //风险标签
            "Theft",
            "Stolen Crypto"
        ],
        "risk_detail": {        
            "is_blacklist_address": true, 
            "hit_direct_risk_review": false, //命中直接风险审查
            "hit_indirect_risk_review": true, //命中间接风险审查
            "hit_aml_review": true,  //命中反洗钱审查
        }
    }
}

返回字段说明

参数名	数据类型	描述
code	int	业务状态码。200：请求成功；其他值表示请求失败（具体错误码以实际返回为准）。
message	string	接口请求状态描述，例如：success。
data	object	返回数据对象。

---

data 字段说明

参数名	数据类型	描述
unique_id	string	唯一请求 ID（标识当前风险筛查请求，可用于日志追踪与问题排查）。
tcr_score	int	地址风险评分（TCR Score）。数值越高表示风险程度越高。
risk_level	string	风险等级：severe（严重）、high（高风险）、medium（中风险）、low（低风险）、none（未命中风险或未知）。
risk_types	string[]	风险类型数组（风险大类），例如：["Stolen Crypto"]。
risk_tags	string[]	风险标签数组（更细粒度风险标签），例如：["Theft","Stolen Crypto"]。
risk_detail	object	风险明细对象（风险命中情况说明）。

---

risk_detail 字段说明

参数名	数据类型	描述
is_blacklist_address	boolean	是否为黑名单地址（平台公共风险库判定结果）。
hit_direct_risk_review	boolean	是否命中直接风险review。
hit_indirect_risk_review	boolean	是否命中间接风险审review。
hit_aml_review	boolean	是否命中反洗钱review。