This topic explains how to use DescribeRiskScore to retrieve the risk score and risk checklist for an address, aiding on-chain transaction entities in conducting preliminary risk assessments prior to transactions. Based on the risk profile of the on-chain address, you can take appropriate measures.
Initiate a query request
-
API Name: DescribeRiskScore
-
Endpoint: cloudauth-intl.cn-hongkong.aliyuncs.com
-
Request Method: HTTPS POST
-
API Description: Query the risk score and risk checklist for an address
Request parameters
Name | Type | Required | Description |
MerchantBizId | String | Yes | A custom business unique identifier defined by the client-side, used for subsequent problem location and troubleshooting. Note ID Verification does not check the uniqueness of the value. To better track, it is strongly recommended to ensure uniqueness. |
Coin | String | Yes | The public blockchain where the address to be queried is located. For more information, see the public blockchain support list. |
Address | String | Yes | The on-chain address to be queried. |
Return data
Name | Type | Description | ||
HTTP Status Code | Integer | HTTP status code. | ||
HTTP Body | RequestId | String | The unique identifier of the request, which can be used to locate problems. | |
Code | String | Return code. For more information, see the return code and message. | ||
Message | String | Error message. | ||
Data | Object | None. | ||
- | Score | Integer | Comprehensive risk score. | |
- | RiskLevel | String | Risk level. | |
- | HackingEvent | String | Hacking event. | |
- | DetailList | String[] | Detail list. | |
Risk event overview
Risk event | Description |
Malicious Address | Addresses directly involved in malicious events, such as DeFi protocol exploiters, centralized exchange hackers, sanctioned addresses, etc. |
Suspected Malicious Address | Addresses related to malicious events. |
High-risk Tag Address | High-risk entity addresses, such as mixers, nested transactions, etc. |
Medium-risk Tag Address | Medium-risk entity addresses, such as gambling, exchanges that do not require KYC, etc. |
Mixer | Mixer entity addresses, such as Tornado Cash, etc. |
Risk Exchange | Exchanges that do not require KYC. |
Gambling | Gambling entity addresses. |
Involved Theft Activity | Addresses involved in theft events. |
Involved Ransom Activity | Addresses involved in ransom events. |
Involved Phishing Activity | Addresses involved in phishing events. |
Interact With Malicious Address | Associated with malicious addresses. |
Interact With Suspected Malicious Address | Associated with suspected malicious addresses. |
Interact With High-risk Tag Address | Associated with high-risk addresses. |
Interact With Medium-risk Tag Addresses | Associated with medium-risk addresses. |
Risk level overview
Risk level | Recommended actions |
Severe | Prohibit withdrawal transactions and immediately report the address. |
High | Maintain high-level monitoring and conduct transaction analysis through the MistTrack AML platform or OpenAPI. |
Moderate | Requires moderate supervision. |
Low | Requires minimal supervision. |