5、黑名单地址检测接口

说明：此接口只检测钱包地址是否是黑名单。此接口不执行规则引擎配置的策略，也不检测用户在KYT系统配置的私有数据。

1. 接口URL

GET /openapi/v3/risk/address/blacklist

2. 请求参数

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

3. 返回参数

{
    "code": 200,
    "message": "success",
    "data": {
        "unique_id": "0140......8be5", 
        "risk_level": "severe", 
        "risk_types": "Sanctions", 
        "risk_tags":[ 
            "chenzhi",
            "prince group",
            "Sanctions"
        ]
        "risk_detail":{
            "is_blacklist_address": true, 
        }
    }
}

返回字段说明

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

---

data 字段说明

参数名	数据类型	描述
unique_id	string	唯一请求 ID（标识当前黑名单检测请求，可用于日志追踪与问题排查）。
risk_level	string	风险等级：severe（严重）、high（高风险）、medium（中风险）、low（低风险）。说明：黑名单权重策略调整后，等级可能不固定为 severe。
risk_types	string	风险类型（黑名单所属风险类别），例如：Sanctions。
risk_tags	string[]	风险标签数组（更细粒度标签），例如：["Sanctions","Prince Group"]。
risk_detail	object	风险明细对象。

---

risk_detail 字段说明

参数名	数据类型	描述
is_blacklist_address	boolean	是否为黑名单地址。true 表示命中黑名单；false 表示未命中。