# Get Risk Score(KYT/KYA)

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.

#### HTTP Request

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

> Try this endpoint in your [browser](https://openapi.misttrack.io/v2/risk_score?coin=ETH\&address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\&api_key=YourApiKey) 🔗

{% tabs %}
{% tab title="Request" %}
Query Parameters

<table><thead><tr><th width="161.66666666666666">Parameter</th><th width="164">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="../../openapi/overview#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 %}
{% endtab %}

{% tab title="Response" %}
Response Data 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><tr><td>risk_report_url</td><td>string</td><td>The MistTrack AML Risk Report (PDF) generated for this KYT/KYA risk score query.</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
            }
        ],
        "risk_report_url": "https://light.misttrack.io/riskReport/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?token=39407df8-a72f-4fa7-ab8b-c9034af97ff7"
    }
}
```

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