5. Blacklist Address Detection API

Description

This endpoint only checks whether a wallet address is on the blacklist.

It does not execute rule engine–configured strategies and does not evaluate any private data configured by the user in the KYT system.

1. Endpoint URL

GET /openapi/v3/risk/address/blacklist

2. Request Parameters

Parameter	Type	Required	Description
apikey	string	true	API key
address	string	true	Wallet address

3. Response Parameters

{
  "code": 200,
  "message": "success",
  "data": {
    "unique_id": "0140......8be5",
    "risk_level": "severe",
    "risk_types": "Sanctions",
    "risk_tags": [
      "chenzhi",
      "prince group",
      "Sanctions"
    ],
    "risk_detail": {
      "is_blacklist_address": true
    }
  }
}

Response Field Description

Field	Type	Description
code	int	Business status code. `200` indicates success; other values indicate failure (refer to actual error codes returned).
message	string	Response status message, e.g., `success`.
data	object	Response data object.

`data` Field Description

Field	Type	Description
unique_id	string	Unique request ID (used for tracking and troubleshooting).
risk_level	string	Risk level: `severe`, `high`, `medium`, `low`. Note: After blacklist weight strategy adjustments, the level may not always be `severe`.
risk_types	string	Risk type (risk category associated with the blacklist), e.g., `Sanctions`.
risk_tags	string[]	Risk tag array (more granular labels), e.g., `["Sanctions","Prince Group"]`.
risk_detail	object	Risk detail object.

`risk_detail` Field Description

Field	Type	Description
is_blacklist_address	boolean	Whether the address is on the blacklist. `true` indicates a blacklist hit; `false` indicates no match.