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.