4. Wallet Address Risk Screening API
Description
Performs risk screening on a wallet address.
This endpoint 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/screening
2. Request Parameters
3. Response Parameters
{
"code": 200,
"message": "success",
"data": {
"unique_id": "0140......8be5",
"tcr_score": 41,
"risk_level": "severe",
"risk_types": [
"Stolen Crypto"
],
"risk_tags": [
"Theft",
"Stolen Crypto"
],
"risk_detail": {
"is_blacklist_address": true,
"hit_direct_risk_review": false,
"hit_indirect_risk_review": true,
"hit_aml_review": 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). |
| tcr_score | int | Address risk score (TCR Score). A higher value indicates a higher level of risk. |
| risk_level | string | Risk level: severe, high, medium, low, none (no risk detected or unknown). |
| risk_types | string[] | Risk type array (high-level categories), e.g., ["Stolen Crypto"]. |
| risk_tags | string[] | Risk tag array (more granular labels), e.g., ["Theft","Stolen Crypto"]. |
| risk_detail | object | Risk detail object (description of matched risk conditions). |
risk_detail Field Description
| Field | Type | Description |
|---|
| is_blacklist_address | boolean | Whether the address is classified as a blacklist address (based on the platform’s public risk database). |
| hit_direct_risk_review | boolean | Whether direct risk review rules were triggered. |
| hit_indirect_risk_review | boolean | Whether indirect risk review rules were triggered. |
| hit_aml_review | boolean | Whether AML review rules were triggered. |