# Get Risk Score(Asynchronous API)

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.

<figure><img src="/files/cNG1AZuoLsq4EuHMvmXN" alt=""><figcaption></figcaption></figure>

## 1. Create Task API

#### HTTP Request

```shell
POST https://openapi.misttrack.io/v2/risk_score_create_task
```

**Parameters**

<table><thead><tr><th width="174.96484375">Parameter</th><th width="132.71484375">Type</th><th>Description</th></tr></thead><tbody><tr><td>coin</td><td>string</td><td>the coin to check for risk score, <strong>all optional values can be found</strong> <a href="/pages/4iOi28DV0NUUh4ETEpMx#multi-chain-support"><strong>here</strong></a></td></tr><tr><td>address</td><td>string</td><td>the address to check for risk score, optional.</td></tr><tr><td>txid</td><td>string</td><td>the transaction hash to check for risk score, optional.</td></tr><tr><td>api_key</td><td>string</td><td>your api key</td></tr></tbody></table>

{% hint style="info" %}
Pass either `address` or `txid` as the target. Do not pass both.
{% endhint %}

**Request Header**

Content-Type: application/json

**Request Demo**

```sh
curl --location 'https://openapi.misttrack.io/v2/risk_score_create_task'
--header 'Content-Type: application/json'
--data '{
    "address": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
    "coin": "TRX",
    "api_key": "YourApiKey"
}'
```

**Response Parameters**

<table><thead><tr><th width="175.41015625">Parameter</th><th width="132.73046875">Type</th><th>Description</th></tr></thead><tbody><tr><td>has_result</td><td>bool</td><td>Whether the task has a result.</td></tr><tr><td>scanned_ts</td><td>int</td><td>Timestamp, indicating the time when the task result is generated.</td></tr></tbody></table>

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

```json
{"success": true, "msg": "", "data": {"scanned_ts": 0, "has_result": false}}
```

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

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

```json
{"success": true, "msg": "", "data": {"scanned_ts": 1753093189, "has_result": true}}
```

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

## 2. Query Task Result API

{% hint style="info" %}
This API has **NO** rate limit.
{% endhint %}

#### HTTP Request

```sh
GET https://openapi.misttrack.io/v2/risk_score_query_task
   ?coin=ETH
   &address={address}
   &txid={txn hash}
   &api_key=YourApiKey
```

**Parameters**

<table><thead><tr><th width="174.6484375">Parameter</th><th width="132.55078125">Type</th><th>Description</th></tr></thead><tbody><tr><td>coin</td><td>string</td><td>the coin to check for risk score, <strong>all optional values can be found</strong> <a href="/pages/4iOi28DV0NUUh4ETEpMx#multi-chain-support"><strong>here</strong></a></td></tr><tr><td>address</td><td>string</td><td>the address to check for risk score, optional.</td></tr><tr><td>txid</td><td>string</td><td>the transaction hash to check for risk score, optional.</td></tr><tr><td>api_key</td><td>string</td><td>your api key</td></tr></tbody></table>

{% hint style="info" %}
Pass either `address` or `txid` as the target. Do not pass both.
{% endhint %}

**Response Parameters**

* The task is not completed.

```json
{"success": true, "msg": "TaskUnderRunning"}
```

* The task has been completed.

{% tabs %}
{% tab title="Response" %}
Parameters

<table><thead><tr><th width="210">Parameter</th><th width="107.66666666666666">Type</th><th>Description</th></tr></thead><tbody><tr><td>score</td><td>int</td><td>Risk Score for the query address, range: 3 ~ 100</td></tr><tr><td>hacking_event</td><td>string</td><td>Related security event/incident name for the query address</td></tr><tr><td>detail_list</td><td>list</td><td>Risk description for the query address</td></tr><tr><td>risk_level</td><td>string</td><td>Risk level, <a href="#risk-level-guide">Low / Moderate / High / Severe</a></td></tr><tr><td>risk_detail</td><td>list</td><td>Data for the risk score calculation process.</td></tr></tbody></table>

Parameters for `risk_detail`

<table><thead><tr><th width="142.8359375">Parameter</th><th width="88.26953125">Type</th><th>Description</th></tr></thead><tbody><tr><td>entity</td><td>string</td><td>The name of the entity involved in the risk, example: garantex.io, this field is not enumerable.</td></tr><tr><td>risk_type</td><td>string</td><td><ul><li>sanctioned_entity</li><li>illicit_activity</li><li>mixer</li><li>gambling</li><li>risk_exchange</li><li>bridge</li></ul></td></tr><tr><td>exposure_type</td><td>string</td><td><ul><li>direct</li><li>indirect</li></ul></td></tr><tr><td>hop_num</td><td>int</td><td>How many hops to the risk entity, greater than or equal to 1.</td></tr><tr><td>volume</td><td>float</td><td>Total transaction amount with the risk entity (in USD).</td></tr><tr><td>percent</td><td>float</td><td>Percentage of total transaction amount.</td></tr></tbody></table>

Sample Response

```json
{
    "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
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

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

<table><thead><tr><th width="163">Risk Level</th><th width="138">Risk Score</th><th>Suggested Operations</th></tr></thead><tbody><tr><td>Severe</td><td>91 ~ 100</td><td>Prohibit withdrawals &#x26; trade, and report address immediately</td></tr><tr><td>High</td><td>71 ~ 90</td><td>Maintain high level surveillance, and analyze via MistTrack AML platform or OpenAPI to conduct transaction analysis</td></tr><tr><td>Moderate</td><td>31 ~ 70</td><td>Moderate supervision required</td></tr><tr><td>Low</td><td>0 ~ 30</td><td>Minimal supervision required</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.misttrack.io/api-endpoints/get-risk-score-asynchronous-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.