MistTrack Docs
  • 👏Welcome to MistTrack
  • 🌟MistTrack Features
  • 📖Change Log
  • 🔗OpenAPI
    • Introduction
    • Overview
    • Quicknode Add-on Docs
  • 🎯api endpoints
    • Get API Status
    • Get Address Labels
    • Get Address Overview
    • Get Risk Score
    • Get Transactions Investigation
    • Get Address Actions
    • Get Address Profile
    • Get Address Counterparty
  • 💬support
    • Common Error Messages
    • Getting Help
Powered by GitBook
On this page
  • Risk Descriptions For detail_list
  • Risk Level Guide
  1. api endpoints

Get Risk Score

PreviousGet Address OverviewNextGet Transactions Investigation

Last updated 2 months ago

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.

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

Try this endpoint in your 🔗

Query Parameters

Parameter
Type
Description

coin

string

address

string

the address to check for risk score, one of address and txid must be passed.

txid

string

the transaction hash to check for risk score, one of address and txid must be passed.

api_key

string

your api key

Response Data 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_detail

list

Data for the risk score calculation process.

type values:

  • malicious

  • suspected_malicious

  • high_risk

  • medium_risk

Sample Response

{
    "success":true,
    "msg":"",
    "data":{
        "score":3,
        "hacking_event":"",
        "detail_list":[
            "Interact With Malicious Address",
            "Interact With High-risk Tag Address",
            "Interact With Medium-risk Tag Addresses"
        ],
        "risk_level":"Low",
        "risk_detail":[
            {
                "label":"Tornado.Cash: Router",
                "type":"high_risk",
                "volume":1338984,
                "address":"0xd90e2f925da726b50c4ed8d0fb90ad053324f31b",
                "percent":0.453
            },
            {
                "label":"Tornado.Cash: L1 Helper",
                "type":"high_risk",
                "volume":1859.7,
                "address":"0xca0840578f57fe71599d29375e16783424023357",
                "percent":0.001
            },
            {
                "label":"Tornado.Cash: Proxy",
                "type":"high_risk",
                "volume":1487760,
                "address":"0x722122df12d4e14e13ac3b6895a86e84145b6967",
                "percent":0.503
            },
            {
                "label":"Tornado.Cash: 10 ETH",
                "type":"high_risk",
                "volume":167204.511,
                "address":"0x910cbd523d972eb0a6f4cae4618ad62622b39dbf",
                "percent":0.057
            },
            {
                "label":"HitBTC",
                "type":"medium_risk",
                "volume":76090.41,
                "address":"0x9c67e141c0472115aa1b98bd0088418be68fd249",
                "percent":0.026
            }
        ]
    }
}

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

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

the coin to check for risk score, all optional values can be found

Risk level,

🎯
browser
here
Low / Moderate / High / Severe