一、地址充值｜提现风险预警接口

说明：支持地址充值或提现交易场景，预先检测地址风险(例如：是否是黑名单、是否直接或间接黑名单交易过等等)。

1、接口URL

GET /openapi/v2/risk/address/check

2、header参数

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

3、请求参数

参数名	数据类型	是否必传	描述
api_key	string	true	apikey
network	string	true	主网名称(Bitcoin、Ethereum、...... 详见《主网代币枚举值》)
address	string	true	钱包地址
address_role	string	true	地址角色（ from：转出地址； to：转入地址 ）
coin	string	true	代币名称(btc、eth、trx、bnb、usdt、usdc......详见主网代币枚举值)
app_id	string	true	应用id（在WEB端KYT配置页面获取）
value	float64	false	代币数量
query_indirect_risk	bool	false	是否查询间接风险（默认值true）
business_tag	string	false	业务类型（ 钱包：wallet 交易所：exchange NFT：nft... 等等 ）
kyc_status	int	false	KYC状态（ 1：已KYC认证 2：未KYC认证 ）
kyc_level	int	false	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, //200:代表成功
    "msg": "success",
    "data": {
        "unique_id": "0140......8be5", //唯一标识id(用于查询历史记录) 
        "risk_level": "severe", //风险等级（严重、高、中、低、未知）
        "risk_code": 4444, //风险code
        "risk_source": { //风险来源
            "is_private_whitelist": false, //是否命中私有白名单
            "is_private_balcklist": false, //是否命中私有黑名单  
            "black_address_type": "Blackmail Scam", //黑名单类型
            "black_address_label": [ //黑名单标签
                "attacker",
                "hacker"
            ],
            "direct_risk_list":[ //直接风险交易列表
                {
                    "black_address": "1KHw......aGbX", //直接交易的黑名单地址
                    "black_address_type": "Blackmail Scam", //风险类型
                    "tx_hash": "2bc34......b693", //交易hash
                    "black_address_label": [ //黑名单标签
                        "attacker",
                        "hacker"
                    ],
                }, 
                ......
            ],
            "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.black_address_type	string	黑名单类型
risk_source.black_address_label	array	黑名单标签
risk_source.is_private_whitelist	bool	是否是私有白名单
risk_source.is_private_balcklist	bool	是否是私有黑名单
risk_source.direct_risk_list	jsonArray	地址的直接风险交易列表
risk_source.indirect_risk_list	jsonArray	地址的直接风险交易列表