Get Risk Score(KYT/KYA) V3.0
🌟 What’s New in Risk Score V3.0
1. New in API Response
The API response introduces a new field address_label, which returns the entity label associated with the address (in txid + direction scenarios, it returns the label of the corresponding from/to address). It also adds a nested field hop_dic under risk_detail, which describes the multi-hop fund flow path between the queried address and each risk entity, representing the full transaction path by hop level, where the key is the hop level and the value is the list of addresses at that level.
2. New in Query Parameters
A new query parameter direction is added and only takes effect when txid is provided. It is used to specify the transaction analysis direction (deposit / withdraw, default: deposit), determining whether risk calculation is performed from the incoming or outgoing side of the transaction.
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 associated with the given address. All assets on the same blockchain will return the same result regardless of the coin parameter.
HTTP Request
GET https://openapi.misttrack.io/v3/risk_score
?coin=ETH
&txid={txn hash}
&direction=deposit
&api_key=YourApiKeyGET https://openapi.misttrack.io/v3/risk_score
?coin=ETH
&address={address}
&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.
direction
string
optional values: deposit, withdraw , default: deposit
Indicates transaction direction when txid is provided.
api_key
string
your api key
Provide either address or txid as the target. Do not both.
Response Data Parameters
score
int
Risk score of the queried address. Range: 3–100.
hacking_event
string
Related security incident associated with the address (if any).
detail_list
list
List of risk indicators associated with the address.
risk_detail
list
Detailed breakdown of risk exposures used in score calculation.
address_label
string
Entity label of the queried address.
When txid and direction are provided, this refers to the label of the from or to address in the transaction.
risk_report_url
string
URL to download the MistTrack AML risk report (PDF) for this query.
Parameters for risk_detail
entity
string
Name of the associated risk entity (e.g., 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
Number of hops between the queried address and the risk entity. Minimum value: 1.
hop_dic
dict
Represents the transaction path between the queried address and the risk entity. Keys indicate hop levels, and values are arrays of addresses at each step.
volume
float
Total transaction volume associated with the risk entity (in USD).
percent
float
Proportion of this risk exposure relative to the total transaction volume.
Sample Response
Risk Descriptions For detail_list
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
Severe
91 ~ 100
Prohibit 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