Get Risk Score(Asynchronous API)

Asynchronous Mode

Returns the risk score, risk detail list for a given address or transaction hash.

Note: This API calculates the risk score based on all transactions related to the address in question. Therefore, all tokens owned by the address will receive the same score.

1. Create Task API

HTTP Request

POST https://openapi.misttrack.io/v2/risk_score_create_task

Parameters

Parameter	Type	Description
coin	string	the coin to check for risk score, all optional values can be found here
address	string	the address to check for risk score, optional.
txid	string	the transaction hash to check for risk score, optional.
api_key	string	your api key

Pass either address or txid as the target. Do not pass both.

Request Header

Content-Type: application/json

Request Demo

curl --location 'https://openapi.misttrack.io/v2/risk_score_create_task'
--header 'Content-Type: application/json'
--data '{
    "address": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
    "coin": "TRX",
    "api_key": "YourApiKey"
}'

Response Parameters

Parameter	Type	Description
has_result	bool	Whether the task has a result.
scanned_ts	int	Timestamp, indicating the time when the task result is generated.

• Case-1: Task submitted, cache miss, the API response is as follows:

{"success": true, "msg": "", "data": {"scanned_ts": 0, "has_result": false}}

You can wait 1-10 seconds and then call the API /v2/risk_score_query_task to get the result.

• Case-2: Task submitted, cache hit, the API response is as follows:

{"success": true, "msg": "", "data": {"scanned_ts": 1753093189, "has_result": true}}

You can immediately call the API /v2/risk_score_query_task to get the result.

2. Query Task Result API

This API has NO rate limit.

HTTP Request

GET https://openapi.misttrack.io/v2/risk_score_query_task
   ?coin=ETH
   &address={address}
   &txid={txn hash}
   &api_key=YourApiKey

Parameters

Parameter	Type	Description
coin	string	the coin to check for risk score, all optional values can be found here
address	string	the address to check for risk score, optional.
txid	string	the transaction hash to check for risk score, optional.
api_key	string	your api key

Pass either address or txid as the target. Do not pass both.

Response Parameters

• The task is not completed.

{"success": true, "msg": "TaskUnderRunning"}

• The task has been completed.

Response

Parameters

Parameter	Type	Description
score	int	Risk Score for the query address, range: 3 ~ 100
hacking_event	string	Related security event/incident name for the query address
detail_list	list	Risk description for the query address
risk_level	string	Risk level, Low / Moderate / High / Severe
risk_detail	list	Data for the risk score calculation process.

Parameters for risk_detail

Parameter	Type	Description
entity	string	The name of the entity involved in the risk, example: garantex.io, this field is not enumerable.
risk_type	string	sanctioned_entity illicit_activity mixer gambling risk_exchange bridge
exposure_type	string	direct indirect
hop_num	int	How many hops to the risk entity, greater than or equal to 1.
volume	float	Total transaction amount with the risk entity (in USD).
percent	float	Percentage of total transaction amount.

Sample Response

{
    "success": true, 
    "msg": "", 
    "data": {
        "score": 35, 
        "hacking_event": "", 
        "detail_list": [
            "Involved Illicit Activity", 
            "Interact With High-risk Tag Address"
        ], 
        "risk_level": "Moderate", 
        "risk_detail": [
            {
                "entity": "huionepay", 
                "risk_type": "sanctioned_entity", 
                "volume": 6700352.55, 
                "hop_num": 2, 
                "exposure_type": "indirect", 
                "percent": 3.419
            }, 
            {
                "entity": "huionepay", 
                "risk_type": "sanctioned_entity", 
                "volume": 3466297, 
                "hop_num": 1, 
                "exposure_type": "direct", 
                "percent": 1.769
            }, 
            {
                "entity": "www.hwdb.la", 
                "risk_type": "sanctioned_entity", 
                "volume": 224267, 
                "hop_num": 2, 
                "exposure_type": "indirect", 
                "percent": 0.114
            }, 
            {
                "entity": "Guarantee Merchant", 
                "risk_type": "illicit_activity", 
                "volume": 7301824.568, 
                "hop_num": 1, 
                "exposure_type": "indirect", 
                "percent": 3.726
            }, 
            {
                "entity": "Theft", 
                "risk_type": "illicit_activity", 
                "volume": 4515631, 
                "hop_num": 7, 
                "exposure_type": "indirect", 
                "percent": 2.304
            }, 
            {
                "entity": "Guarantee Merchant", 
                "risk_type": "illicit_activity", 
                "volume": 1607263.16, 
                "hop_num": 5, 
                "exposure_type": "indirect", 
                "percent": 0.82
            }, 
            {
                "entity": "Guarantee Merchant", 
                "risk_type": "illicit_activity", 
                "volume": 69478, 
                "hop_num": 4, 
                "exposure_type": "indirect", 
                "percent": 0.035
            }
        ]
    }
}

Risk Descriptions For detail_list

Risk Item	Risk Description
Malicious Address	Address directly involved in malicious events, example: DeFi protocol exploiters, centralized exchange hackers, sanctioned addresses, etc.
Suspected Malicious Address	Address associated with malicious events
High-risk Tag Address	High-risk entity address, example: Mixers, some nested exchanges, etc.
Medium-risk Tag Address	Medium-risk entity address, example: Gambling, exchanges not requiring KYC, etc.
Mixer	Mixer entity address, example: Tornado Cash, etc.
Sanctioned Entity	Sanctioned entity address, example: garantex, etc.
Risk Exchange	Exchanges that do not require KYC
Gambling	Gambling entity address
Involved Theft Activity	Address involved in theft events
Involved Ransom Activity	Address involved in ransom events
Involved Phishing Activity	Address involved in phishing events
Involved Illicit Activity	Address involved in illicit activity, example: money laundering, etc.
Interact With Malicious Address	Interactions with malicious address
Interact With Suspected Malicious Address	Interactions with suspected malicious address
Interact With High-risk Tag Address	Interactions with high-risk address
Interact With Medium-risk Tag Addresses	Interactions with medium-risk address

Risk Level Guide

Risk Level	Risk Score	Suggested Operations
Severe	91 ~ 100	Prohit withdrawals & trade, and report address immediately
High	71 ~ 90	Maintain high level surveillance, and analyze via MistTrack AML platform or OpenAPI to conduct transaction analysis
Moderate	31 ~ 70	Moderate supervision required
Low	0 ~ 30	Minimal supervision required