3、实时交易风险告警接口

说明：支持对最新实时交易（最近24小时内）的风险筛查。用于自己作为资金接收方，链上交易发生后进行风险筛查，聚焦交易资金来源的风险。此接口会执行规则引擎配置的策略。

1. 接口URL

GET /openapi/v3/risk/rule/tx/screening

2. 请求参数

参数名	数据类型	是否必传	描述
apikey	string	true	apikey
tx	string	true	交易hash
chain	string	true	主链名称
to_address	string	true	代币接收地址
coin	string	true	代币名称
app_id	string	true	应用id

3. 返回参数

{
    "code": 200,
    "message": "success",
    "data": { 
        "unique_id": "2541......c245", 
        "risk_level": "severe", 
        "risk_types": [
            "Blackmail Scam"         
        ],
        "risk_tags":[
            "phishing",
            "Blackmail Scam"
        ],
        "risk_code": 4444, 
        "risk_detail": {      
            "private_data": { 
                "hit_private_whitelist": false, 
                "hit_private_blacklist": false, 
                "private_blacklist_name":"私有黑名单名称",
            },
            "hit_blacklist_address":true,
            "tx_blacklist_address": [
                {
                    "blacklist_address": "0xE0......D015",
                    "risk_types":"Blackmail Scam",
                    "risk_tags":[ 
                        "phishing"
                    ],
                },
            ], 
            "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[]	风险类型数组（风险大类）。例如：["Blackmail Scam"]。
risk_tags	string[]	风险标签数组（更细粒度风险标签）。例如：["phishing","Blackmail Scam"]。
risk_code	int	风险 code：0（未筛查到风险）、-1（未查询到）、4444（命中黑名单）、其他 code 详见《risk_code说明书》。
risk_detail	object	风险明细信息（策略命中情况、黑名单命中信息等）。

---

risk_detail 字段说明

参数名	数据类型	描述
private_data	object	私有名单命中信息。
hit_blacklist_address	boolean	交易中是否包含黑名单地址（from 或 to）。
tx_blacklist_address	array	交易中命中的黑名单地址列表（可能包含多个）。
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 表示命中黑名单。
private_blacklist_name	string	命中的私有黑名单名称（未命中时可能为空或不返回）。

---

tx_blacklist_address 元素说明

参数名	数据类型	描述
blacklist_address	string	命中的黑名单地址。
risk_types	string	该地址对应的风险类型。
risk_tags	string[]	该地址对应的风险标签数组。