Get Risk Score(KYT/KYA)
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.
HTTP Request
GET https://openapi.misttrack.io/v2/risk_score
   ?coin=ETH
   &address={address}
   &txid={txn hash}
   &api_key=YourApiKeyTry this endpoint in your browser 🔗
Query Parameters
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
Response Data Parameters
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_detail
list
Data for the risk score calculation process.
risk_report_url
string
The MistTrack AML Risk Report (PDF) generated for this KYT/KYA risk score query.
Parameters for risk_detail
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_report_url": "https://light.misttrack.io/riskReport/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?token=39407df8-a72f-4fa7-ab8b-c9034af97ff7"
    }
}Risk Descriptions For detail_list
detail_listMalicious 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
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
Last updated
