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

说明：支持最新实时交易（最近24小时内），对交易hash进行风险检测（参与交易的地址是否包含黑名单、交易地址是否直接或间接和黑名单进行过交易、交易中接收地址交易金额是否超过AML阈值等等）

1、接口URL

GET /openapi/v2/risk/tx/check

2、header参数

参数名	数据类型	是否必传	描述
timestamp	int	true	时间戳（单位s）
sign	string	true	sha256("timestamp=timestamp的值&secret=secretkey的值")

3、请求参数

参数名	数据类型	是否必传	描述
api_key	string	true	apikey
tx	string	true	交易hash(支持查询最近72小时的交易hash)
network	string	true	主网名称(Bitcoin、Ethereum...... 详见《主网代币枚举值》)
to_address	string	true	接收地址
coin	string	true	代币名称(btc、eth、trx、bnb、usdt、usdc......详见主网代币枚举值接口)
app_id	string	true	应用id(在WEB端KYT配置页面获取)
query_indirect_risk	bool	false	是否查询间接风险（默认值true）
business_tag	string	false	业务类型（ 钱包：wallet 交易所：exchange NFT：nft... 等等 ）
kyt_status	int	false	to_address的KYC状态（ 1：已KYC认证 2：未KYC认证 ）
kyc_level	int	false	to_address的KYC等级（ 1：KYC 1级 2：KYC 2级 3：KYC 3级 4：KYC 4级 ）

4、返回参数

apikey过期或错误，返回：

{
    "code": -1,
    "data": {},
    "message": "api_key is invalid"
}

apikey和secrectkey验证通过，正常返回：

{
    "code": 200,
    "msg": "success",
    "data": { 
        "unique_id": "0140......8be5", //唯一标识id(用于查询历史数据)
        "risk_level": "severe", //风险等级（严重、高、中、低、未知）
        "risk_code": 4444 //风险code
        "risk_source": {
            "is_private_whitelist": false, //是否命中私有白名单  
            "is_private_blacklist": false, //是否命中私有黑名单  
            "risk_from_address_list":[ //风险转出地址
                { 
                    "black_address": "3E5L......44Bc",//交易的from地址
                    "black_address_type": "Blackmail Scam", //黑名单地址类型
                    "black_address_label": [ //黑名单地址标签
                        "attacker",
                        "hacker"
                    ],
                },
                ......
            ],
            "risk_to_address_list":[ //风险转入地址
                { 
                    "black_address": "35AT......yzew",//交易的to地址       
                    "black_address_type": "Blackmail Scam", //黑名单地址类型
                    "black_address_label": [ //黑名单地址标签
                        "attacker",
                        "hacker"
                    ],
                },
                ......
            ],
            "direct_tx_from_risk_list":[ //交易发送方地址 的直接风险交易列表
                {
                    "black_address": "1KHw......aGbX", //黑名单
                    "tx_hash": "2bc3......b693",
                    "black_address_type": "Blackmail Scam", //风险类型
                    "black_address_label": [ //黑名单地址标签
                        "attacker",
                        "hacker"
                    ],
                }, 
                ......
            ],
            "direct_tx_to_risk_list":[ //交易接收方地址 的直接风险交易列表
                {
                    "black_address": "1KHw......aGbX", //黑名单
                    "tx_hash": "2bc3......b693",
                    "black_address_type": "Blackmail Scam", //风险类型
                    "black_address_label": [ //黑名单标签
                        "attacker",
                        "hacker"
                    ],
                }, 
                ......
            ],
            "from_indirect_risk_list":[ //交易发送发间接风险交易列表
                {
                    "indirect_level": 2, //间接层级
                    "black_address":"0x99......4bE1", //间接交易的黑名单
                    "black_address_type": "Blackmail Scam", //风险类型
                    "indirect_tx_list":[ //间接交易hash
                        "0x74......2a90",
                        "0x56......9d4b"
                    ],
                    "black_address_label": [ //黑名单标签
                        "attacker",
                        "hacker"
                    ],
                },
                ......
            ],
            "to_indirect_risk_list":[ //交易接收方间接风险交易列表
                {
                    "indirect_level": 2, //间接层级
                    "black_address":"0x99......4bE1", //间接交易的黑名单
                    "black_address_type": "Blackmail Scam", //风险类型
                    "indirect_tx_list":[ //间接交易hash
                        "0x74......2a90",
                        "0x56......9d4b"
                    ],
                    "black_address_label": [ //黑名单标签
                        "attacker",
                        "hacker"
                    ],
                },
                ......
            ]
        }
    }
}

参数名	数据类型	描述
code	Int	200：请求成功 -2：不支持该主网
message	string	接口请求状态描述
unique_id	string	唯一id（标识当前请求，用于查询历史记录）
risk_level	string	风险等级（ severe：严重 high：高风险 medium：中风险 low：低风险 none：未知 ）
risk_code	int	风险code（ 0：未知 -1：未查询到 4444：命中黑名单 其他code说明详见：《risk_code说明书》 ）
risk_source	jsonArray	风险来源
risk_source.risk_from_address_list	jsonArray	交易发送方地址中的黑名单列表
risk_source.risk_to_address_list	jsonArray	交易接收方地址中的黑名单列表
risk_source.direct_tx_from_risk_list	jsonArray	交易发送方地址的直接风险交易列表
risk_source.direct_tx_to_risk_list	jsonArray	交易接收方地址的直接风险交易列表
risk_source.from_indirect_risk_list	jsonArray	交易发送发地址的间接风险交易列表
risk_source.to_indirect_risk_list	jsonArray	交易接收发地址的间接风险交易列表