2、地址充值|提现场景风险告警接口

说明：在充值或提现交易预先获知对方钱包地址的交易业务场景，提前对钱包地址进行风险筛查。此接口会执行规则引擎配置的策略。

1. 接口URL

GET /openapi/v3/risk/rule/address/screening

2. 请求参数

参数名	数据类型	是否必传	描述
apikey	string	true	apikey
chain	string	true	主链名称
address	string	true	钱包地址
address_role	string	true	地址角色（from：转出地址； to：转入地址 ）
coin	string	true	代币名称
app_id	string	true	应用id
value	float64	false	代币数量

3. 返回参数

{
    "code": 200, 
    "message": "success",
    "data": {
        "unique_id": "0140......8be5",
        "risk_level": "severe",
        "risk_types": [
            "Stolen Crypto"
        ],
        "risk_tags":[ 
            "Theft",
            "Stolen Crypto"
        ],
        "risk_code": 4444, 
        "risk_detail": {
            "private_data": { 
                "hit_private_whitelist": false,
                "hit_private_blacklist": false,
            }, 
            "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（标识当前风险筛查请求，可用于日志追踪与问题排查）。
risk_level	string	风险等级：severe（严重）、high（高风险）、medium（中风险）、low（低风险）、none（未命中风险或未知）。
risk_types	string[]	风险类型数组（风险大类），例如：["Stolen Crypto"]。
risk_tags	string[]	风险标签数组（更细粒度风险标签），例如：["Theft","Stolen Crypto"]。
risk_code	int	风险 code：0（未筛查到风险）、-1（未查询到）、4444（命中黑名单）、其他 code 详见《risk_code说明书》。
risk_detail	object	风险明细对象（策略命中情况、黑名单命中信息等）。

---

risk_detail 字段说明

参数名	数据类型	描述
private_data	object	私有名单命中信息。
is_blacklist_address	boolean	是否为黑名单地址（综合判定结果）。
hit_direct_risk_review	boolean	是否命中直接风险review。
hit_indirect_risk_review	boolean	是否命中间接风险review。
hit_aml_review	boolean	是否命中反洗钱review。

---

private_data 字段说明

参数名	数据类型	描述
hit_private_whitelist	boolean	是否命中私有白名单。true 表示命中。
hit_private_blacklist	boolean	是否命中私有黑名单。true 表示命中。