7、Blacklist address detection api

Description: This API checks if a given address is on the blacklist.

1、URL

GET /openapi/v2/risk/address/blacklist

2、Header Parameters

Parameter nameData typeRequiredDescription
timestampinttrueTimestamp (in seconds)
signstringtrueSignature sha256("timestamp=timestamp value&secret=secretkey value")

3、Request Parameters

Parameter nameData typeRequiredDescription
api_keystringtrueapikey
addressstringtrueWallet address

4、Response Parameters

{
    "code": 200, //200:Represents success
    "msg": "success",
    "data": {
        "unique_id": "0140......8be5", //Unique ID (used to query history)
        "risk_level": "severe", //Risk level (severe, high, medium, low, unknown)
        "risk_code": 4444, //Risk code
        "risk_source": { //Risk source
            "is_private_whitelist": false, //Whether to hit private whitelist
            "is_private_blacklist": false, //Whether to hit private blacklist
            "black_address_type": "Blackmail Scam", //Blacklist type
            "black_address_label": [ //Blacklist label
                "attacker",
                "hacker"
            ]
        }
    }
}
Parameter nameData typeDescription
codeInt

200: The request was successful

-2: The mainnet is not supported

messagestringInterface Request Status Description
unique_idstringUnique id (identifies the current request, used to query history)
risk_levelstring

Risk level(

severe

high

medium

low

none

risk_codeint

Risk code(

0: unknown

-1: Not found

4444: hit blacklist

details for "Risk_Code Instruction manual")

risk_sourcejsonRisk source
risk_source.is_private_whitelistbooleanWhether to hit private whitelist
risk_source.is_private_blacklistbooleanWhether to hit private blacklist
risk_source.black_address_typestringThe blacklist type of the query address
risk_source.black_address_labelstringArrayCheck the blacklist label of the address