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=YourApiKey

GET https://openapi.misttrack.io/v3/risk_score
   ?coin=ETH
   &address={address}
   &api_key=YourApiKey

Try this endpoint in your browser 🔗

Request

Query 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.
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

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	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