Ctrlk

Get Risk Score(Async API) V3

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/v3/risk_score_create_task

Parameters

Parameter
Type
Required
Description

coin

string

yes

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

address

string

conditional

The address to check for risk score, required when txid is empty.

txid

string

conditional

The transaction hash to check for risk score, required when address is empty.

direction

string

no

Used for transaction hash queries. Optional values: deposit, withdraw. Default: deposit.

api_key

string

yes

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/v3/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.

task_id

string

Use this value to query the task result.

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

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

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

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

2. Query Task Result API

This API has NO rate limit.

HTTP Request

Parameters

Parameter
Type
Required
Description

task_id

string

yes

The task id returned by /v3/risk_score_create_task.

api_key

string

yes

Your API key

Response Parameters

  • The task is not completed.

  • The task was not found.

  • The task has been completed.

Parameters

Parameter
Type
Description

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_level

string

Risk level, Low / Moderate / High / Severe

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

Parameter
Type
Description

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

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

PreviousGet Risk Score(Async API)NextGet Transactions Investigation

Last updated