# Welcome to MistTrack

MistTrack was created by [SlowMist](https://www.slowmist.com/en/) as an anti-money laundering (AML) tracking tool that focuses on combating cryptocurrency money laundering activities.

Our vision is to create a crypto tracking and compliance platform for everyone.

The MistTrack AML tracking system has amassed over 300 million addresses that contain various wallets from major trading platforms throughout the world. 

MistTrack provides full intelligence data assistance for AML analysis and research. It has compiled thousands of addresses belonging to various entities, along with 500K Threat Intelligence addresses, and over 90M addresses that are tied to malicious activities. 

MistTrack currently supports users to investigate wallets on the Bitcoin, Ethereum, BNB Smart Chain, TRON, Polygon, IoTeX, Avalanche-C, Arbitrum One, OP Mainnet, Base, zkSync Era, Merlin Chain and Toncoin, and we will be adding more networks in the future. [Click to check the full list.](/openapi/overview#multi-chain-support)

### Get started with [*MistTrack for free ->*](https://dashboard.misttrack.io)


# MistTrack Features

The things that really powering you up and makes you professional

## [<mark style="color:red;">Click to view the latest introduction document.</mark>](https://docs.google.com/document/d/1R77MToe09Mbz5nQAexjeNc_me3bGxaJaPP0wxsY9Xf0/edit?usp=sharing)

### AML Risk Score

The AML risk score is a score assigned to an address owner by analyzing its historical transaction data against SlowMist's database of malicious wallets. If an address belongs to a high-risk entity, such as a mixer, or if it received cash from it, it will be assigned a high risk score. Any confirmed addresses involved in illicit activities such as extortion, theft, phishing, and/or fraud are automatically marked as risky in SlowMist’s database. In other words, you can analyze the risks associated with each wallet address like a professional compliance officer and determine if the wallet address contains illegal funds.

### Address Labels

Our address labels are able to identify the entity behind it, such as Coinbase or Binance. It can also identify several on-chain and off-chain tags, such as ENS, MEV Bots, DeFi Whales, as well as the type of wallet that’s being used, such as imToken/ or MetaMask. Users can gain a better understanding of the address in question through the use of our Address Label tool.

### Transaction Analysis

Standard blockchain explorers are arduous and not very intuitive. Users have to examine the details of each transaction one at a time using these block explorers. MistTrack simplifies the process by analyzing all past transactions associated with the address and compiles all its data in a way that's easy to understand. This allows us to create behavioral profiles of the targeted address within our platform. Simultaneously, the system performs a segmented analysis of all signed transactions associated with the addresses. Transactions on an address are also classified according to the time of signature, providing users with insight on time zones and active time periods.

### Favorites & Monitoring

Users have the ability to favorite and collect relevant information from addresses using our Favorites and Monitoring feature. All information is kept private and is only accessible by the user. Users may also add the addresses of crypto whales and KOL to monitor their on-chain activities, observe their most recent transactions in real-time, and track their investments. All notifications are stored indefinitely and can be viewed or downloaded at any time.

### Investigations

The system displays a graph that shows how all incoming and outgoing transactions for the address are related to each other. Data can be filtered and sorted directly from the graph and pertinent information can be monitored.

### Get started with [*MistTrack for free ->*](https://dashboard.misttrack.io/)


# Change Log

Growth & Optimization

## June 16, Adding many new features

1. adding the OpenAPI module, making it more convenient for developers to analyze addresses. Users can create three Keys, and each Key can be called 10,000 times per day. [OpenAPI Docs](https://docs.misttrack.io/openapi/)
2. adding the BNB Smart Chain(BSC) support
3. optimized the user experience of graph display

More details 👉 <https://twitter.com/MistTrack_io/status/1537429464702853121>

## May 23, Adding some features

1. adding the investigation sharing function
2. adding the dark mode

More details 👉 <https://twitter.com/MistTrack_io/status/1528927980721872896>

## May 12, Adding  tutorial video

{% embed url="<https://www.youtube.com/watch?v=JCC6t4gTxyo>" %}

[Introducing MistTrack: A Crypto Tracking and Compliance Platform for Everyone](https://slowmist.medium.com/introducing-misttrack-a-crypto-tracking-and-compliance-platform-for-everyone-3059d73d7fd3)

## May 10, Adding new features

1. Support 8 new ERC-20 tokens:

* WETH
* DAI
* UST
* BUSD
* BNB
* UNI
* ENS
* GRT

2\. When the query address has multiple tokens, it will be displayed. Click the token to view the address details.

![](https://pbs.twimg.com/media/FSZp1WwXwAITOkx?format=jpg\&name=medium)

3\. Add clarification on why the AML risk score was assigned based on interactions with risky entities, hacking events, or suspicious transactions. It will also provide incidents associated with the address.

![](https://pbs.twimg.com/media/FSZqD03WQAUyRb8?format=jpg\&name=medium)

## April 27, Official launched

[MistTrack, Making Blockchain Analytics Easy](https://slowmist.medium.com/misttrack-making-blockchain-analytics-easy-6148bb9d83c9)


# Introduction

Welcome to MistTrack OpenAPI document.

MistTrack anti-money laundering tracking system focuses on combating cryptocurrency money laundering activities and is built by SlowMist.

As a means to provide a more convenient address analysis, we've developed the MistTrack OpenAPI for developers to use in their applications.

{% content-ref url="/pages/4iOi28DV0NUUh4ETEpMx" %}
[Overview](/openapi/overview)
{% endcontent-ref %}

{% content-ref url="/pages/RSJvxJdyPpXuOhTswcPJ" %}
[api endpoints](/api-endpoints/get-api-status)
{% endcontent-ref %}

{% content-ref url="/pages/tuXlXOQuDQ5XlUcqRIcE" %}
[Common Error Messages](/support/common-error-messages)
{% endcontent-ref %}


# Overview

To use our OpenAPI, you need to register an account in the MistTrack dashboard [API section](https://dashboard.misttrack.io/apikeys)🔗 and get your API-KEY for making calls to OpenAPI services.

> Note: The MistTrack OpenAPI is currently only supported on the Standard/Compliance/Developer Plan. [Upgrade Plan](https://misttrack.io/pricing.html)🔗 or contact MistTrack to customize development. Email: Support\[at]MistTrack.io

🌟 Tired of writing integration code? Try our AI-assisted tool, [MistTrack Skills](https://github.com/slowmist/misttrack-skills).

### Multi-chain Support

<table><thead><tr><th width="243">Chain</th><th>Coin</th></tr></thead><tbody><tr><td>Ethereum</td><td>ETH, USDT-ERC20, USDC-ERC20, WETH-ERC20, BNB-ERC20, UNI-ERC20, BUSD-ERC20, DAI-ERC20, GRT-ERC20, ENS-ERC20, UST-ERC20, renBTC-ERC20, WBTC-ERC20, TUSD-ERC20, SHIB-ERC20, LINK-ERC20, BAT-ERC20, CRO-ERC20, SUSHI-ERC20, stETH-ERC20, CRV-ERC20, CVX-ERC20, cvxCRV-ERC20, 3Crv-ERC20, LOOKS-ERC20, IOTX-ERC20, APE-ERC20, PYUSD-ERC20, MEME-ERC20, WUSD-ERC20, PEPE-ERC20, cbBTC-ERC20, FLOKI-ERC20, LEO-ERC20, USDS-ERC20, FDUSD-ERC20, USDe-ERC20, USD1-ERC20, WLFI-ERC20, sUSD-ERC20, EURCV-ERC20, EURI-ERC20, USDG-ERC20, EURC-ERC20</td></tr><tr><td>Bitcoin</td><td>BTC</td></tr><tr><td>TRON</td><td>TRX, USDT-TRC20, USDC-TRC20, USDD-TRC20</td></tr><tr><td>BNB Smart Chain(BSC)</td><td>BNB, BUSD-BEP20, USDT-BEP20, WBNB-BEP20, ETH-BEP20, BTCB-BEP20, DOGE-BEP20, USDC-BEP20, SHIB-BEP20, UST-BEP20, DAI-BEP20, Cake-BEP20, BCH-BEP20, USD1-BEP20, TUSD-BEP20, USDe-BEP20, FDUSD-BEP20, EURI-BEP20</td></tr><tr><td>IoTeX</td><td>IOTX</td></tr><tr><td>Polygon</td><td>POL-Polygon, WMATIC-Polygon, WETH-Polygon, USDC-Polygon, USDC.e-Polygon, USDT-Polygon, DAI-Polygon, WBTC-Polygon, AAVE-Polygon, LINK-Polygon, UNI-Polygon, UST-Polygon, SUSHI-Polygon, WUSD-Polygon, BUSD-Polygon</td></tr><tr><td>Avalanche</td><td>AVAX-Avalanche, WAVAX-Avalanche, BTC.b-Avalanche, USDT-Avalanche, USDT.e-Avalanche, USDC-Avalanche, USDC.e-Avalanche, WETH.e-Avalanche, DAI.e-Avalanche, WBTC.e-Avalanche, EURC-Avalanche</td></tr><tr><td>Arbitrum One</td><td>ETH-Arbitrum, USDT-Arbitrum, USDC-Arbitrum, USDC.e-Arbitrum, WETH-Arbitrum, DAI-Arbitrum, WBTC-Arbitrum, LINK-Arbitrum, GMX-Arbitrum, sbfGMX-Arbitrum, STG-Arbitrum, MAGIC-Arbitrum, ARB-Arbitrum, USDS-Arbitrum, USDe-Arbitrum, FDUSD-Arbitrum</td></tr><tr><td>OP Mainnet</td><td>ETH-Optimism, USDT-Optimism, USDC-Optimism, USDC.e-Optimism, OP-Optimism, DAI-Optimism, WBTC-Optimism, WETH-Optimism, SNX-Optimism, sUSD-Optimism, VELO-Optimism, WLD-Optimism, USDe-Optimism</td></tr><tr><td>Base</td><td>ETH-Base, USDC-Base, USDbC-Base, WETH-Base, DEGEN-Base, DAI-Base, cbETH-Base, USDT-Base, WBTC-Base, USDS-Base, wstETH-Base, USDe-Base, LINK-Base, cbBTC-Base, AAVE-Base, LBTC-Base, OM-Base, rETH-Base, CRV-Base, SolvBTC-Base, EURC-Base</td></tr><tr><td>zkSync Era</td><td>ETH-zkSync, ZK-zkSync, USDT-zkSync, USDC-zkSync</td></tr><tr><td>Merlin Chain</td><td>BTC-Merlin</td></tr><tr><td>Toncoin</td><td>TON, USDT-TON</td></tr><tr><td>Solana</td><td>SOL, USDT-Solana, USDC-Solana, Bonk-Solana, JUP-Solana, RAY-Solana, PYTH-Solana, W-Solana, WLFI-Solana, TRUMP-Solana, BUSD-Solana, PYUSD-Solana, USDS-Solana, FDUSD-Solana, DAI-Solana, USDG-Solana, EURC-Solana</td></tr><tr><td>Litecoin</td><td>LTC</td></tr><tr><td>Dogecoin</td><td>DOGE</td></tr><tr><td>Bitcoin Cash</td><td>BCH</td></tr><tr><td>HashKey Chain</td><td>HSK</td></tr><tr><td>Sui</td><td>SUI, wUSDT-SUI, USDC-SUI</td></tr></tbody></table>

### API Endpoint List

| Endpoint                                                   | Description                                                                                                             |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `v1/status`                                                | Returns API status and support coins                                                                                    |
| `v1/address_labels`                                        | Returns a list of labels for a given address                                                                            |
| `v1/address_overview`                                      | Returns the balance and statistics for a given address                                                                  |
| `v3/risk_score`                                            | Returns risk score, risk details and entity labels for a given address/transaction                                      |
| `v3/risk_score_create_task`  &  `v3/risk_score_query_task` | Get risk info in asynchronous mode(KYT/KYA)                                                                             |
| `v1/transactions_investigation`                            | Returns a transaction investigation result for a given address                                                          |
| `v1/address_action`                                        | Returns transaction actions analysis result for a given address                                                         |
| `v1/address_trace`                                         | Returns the profile for a given address, including the interacted platform list and associated threat intelligence data |
| `v1/address_counterparty`                                  | Returns counterparty analysis results for a given address                                                               |

### Common Response Data Structure

<table><thead><tr><th width="191.33333333333331">Field Name</th><th width="212">Field Type</th><th>Description</th></tr></thead><tbody><tr><td><code>success</code></td><td>Boolean</td><td>API request status</td></tr><tr><td><code>msg</code></td><td>String</td><td>Error information message while the request fails</td></tr><tr><td><code>data</code></td><td>Dictionary</td><td>Response data</td></tr></tbody></table>

### Rate Limits

<table><thead><tr><th width="260">Plan Name</th><th>Rate Limits</th></tr></thead><tbody><tr><td>Standard Plan</td><td>1 call per second / key, up to 10k calls per day / key</td></tr><tr><td>Compliance Plan</td><td>5 calls per second / key, up to 50k calls per day / key</td></tr><tr><td>Developer Plan</td><td>10 calls per second / key, pay as you go</td></tr><tr><td>Enterprise Plan</td><td><strong>Unlimited API calls</strong></td></tr></tbody></table>

When under rate limiting, two possible results will be returned:

```json
{"success": false, "msg": "ExceededDailyRateLimit", "retry_after": 12345}
{"success": false, "msg": "ExceededRateLimit", "retry_after": 1}
```

### Error Codes

List of HTTP status codes for API responses.

<table><thead><tr><th width="182.84765625">HTTP status code</th><th>Overview</th></tr></thead><tbody><tr><td>402</td><td><strong>Cause</strong>: MistTrack Plan has expired.<br><strong>Solution</strong>: Please login and renew your subscription <a href="https://dashboard.misttrack.io/upgrade">here</a>.</td></tr><tr><td>429</td><td><strong>Cause</strong>: You are sending requests too quickly.<br><strong>Solution</strong>: Pace your requests. Read the <a href="#rate-limits">Rate limit guide</a>.</td></tr><tr><td>500</td><td><strong>Cause</strong>: Issue on our servers.<br><strong>Solution</strong>: Retry your request after a brief wait and <a href="/pages/VQpkSbJFTORBYcyPPhQZ">contact us</a> if the issue persists.</td></tr></tbody></table>

[Error messages](/support/common-error-messages) in other situations.


# x402 Pay-as-you-go Pricing

x402 Payment

## Pricing

<table><thead><tr><th width="40">#</th><th width="350.5625">x402 API Endpoint</th><th width="282.57421875">Origin Endpoint</th><th>Cost per Request (USD)</th></tr></thead><tbody><tr><td>1</td><td><code>https://openapi.misttrack.io/x402/address_labels</code></td><td><code>v1/address_labels</code></td><td>$0.1</td></tr><tr><td>2</td><td><code>https://openapi.misttrack.io/x402/address_overview</code></td><td><code>v1/address_overview</code></td><td>$0.5</td></tr><tr><td>3</td><td><code>https://openapi.misttrack.io/x402/risk_score</code></td><td><code>v2/risk_score</code></td><td>$1.0</td></tr><tr><td>4</td><td><code>https://openapi.misttrack.io/x402/risk_score_create_task</code></td><td><code>v2/risk_score_create_task</code></td><td>$1.0</td></tr><tr><td>5</td><td><code>https://openapi.misttrack.io/v2/risk_score_query_task</code></td><td><code>v2/risk_score_query_task</code></td><td>$0</td></tr><tr><td>6</td><td><code>https://openapi.misttrack.io/x402/transactions_investigation</code></td><td><code>v1/transactions_investigation</code></td><td>$1.0</td></tr><tr><td>7</td><td><code>https://openapi.misttrack.io/x402/address_action</code></td><td><code>v1/address_action</code></td><td>$0.5</td></tr><tr><td>8</td><td><code>https://openapi.misttrack.io/x402/address_trace</code></td><td><code>v1/address_trace</code></td><td>$0.5</td></tr><tr><td>9</td><td><code>https://openapi.misttrack.io/x402/address_counterparty</code></td><td><code>v1/address_counterparty</code></td><td>$0.5</td></tr></tbody></table>

## Integration Option 1: Code

Python SDK: <https://github.com/slowmist/misttrack-skills/blob/main/scripts/pay.py>

```python
from scripts.pay import request_with_x402

response = request_with_x402(
    url="https://openapi.misttrack.io/x402/address_labels?address=0x...&coin=ETH",
    private_key="your_private_key_hex",
    chain_id=8453, # Base Chain
    auto_pay=True,
)
print(response.json())
```

## Integration Option 2: Agent Skills

​​Getting Started:

<https://github.com/slowmist/misttrack-skills/blob/main/README.md#x402-payment-pay-per-use>

Example Usage:

<https://github.com/slowmist/misttrack-skills/blob/main/skills/payment.md>

## Integration Option 3: Coinbase Agentic Wallet

Open-source repository: <https://github.com/coinbase/agentic-wallet-skills>

Quickstart guide: <https://docs.cdp.coinbase.com/agentic-wallet/quickstart>

### Step-by-Step Guide

> Environment: macOS 15.6

1. Install Coinbase Agentic Wallet Skills

```bash
npx skills add coinbase/agentic-wallet-skills
```

<div align="left"><figure><img src="/files/APLbxSoBsUCvUafDN6Ep" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="/files/Dz5YQPcsxBFWSCDgezGn" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="/files/j8FYjEdbSdXeFrrS6hAv" alt=""><figcaption></figcaption></figure></div>

2. Check Wallet Status

```bash
npx awal@latest status
```

<div align="left"><figure><img src="/files/65XTWjzscyuthXJPeeJ8" alt=""><figcaption></figcaption></figure></div>

Once the wallet is ready, proceed to authentication: <https://docs.cdp.coinbase.com/agentic-wallet/skills/authenticate>

3. Authenticate Your Wallet

```bash
npx awal@latest auth login <email>
```

<div align="left"><figure><img src="/files/sF5Mr6oFEytXu1IcvZmn" alt=""><figcaption></figcaption></figure></div>

4. Check Wallet Address and Balance

```bash
npx awal@latest balance
```

<div align="left"><figure><img src="/files/HA8kv9ze2yYJ16Y1H2Bu" alt=""><figcaption></figcaption></figure></div>

```bash
npx awal@latest address
```

<div align="left"><figure><img src="/files/T9gcItVqOAPQN5b0ndxo" alt=""><figcaption></figcaption></figure></div>

5. Fund Your Wallet

Transfer USDC to the wallet address above using one of the following methods:

* From your personal crypto wallet
* By withdrawing from a centralized exchange

6. Call the MistTrack x402 API and Pay

For more details: <https://docs.cdp.coinbase.com/agentic-wallet/skills/pay-for-service>

```bash
npx awal@latest x402 pay "https://openapi.misttrack.io/x402/address_labels?address=0x3644598cd36c8e3361aee30f6a28521175b33b10&coin=ETH" --max-amount 1000000
```

<div align="left"><figure><img src="/files/TTSTFdB7y10J3QDyUI87" alt=""><figcaption></figcaption></figure></div>

You're all set!


# Quicknode Add-on Docs

JSON RPC example for quicknode add-on

Add-on page: [Address Risk Scores](https://www.quicknode.com/add-ons/address-risk-scores)

## Address Label RPC

### Request Example

{% code overflow="wrap" %}

```json
{"jsonrpc": "2.0", "id": 1, "method": "mt_addressLabel", "params": ["ETH","0xd551234ae421e3bcba99a0da6d736074f22192ff"]}
```

{% endcode %}

<table><thead><tr><th width="140.4765625">Parameter</th><th width="96.4296875">Type</th><th>Description</th></tr></thead><tbody><tr><td>blockchain</td><td>string</td><td>All optional values:<br>ETH<br>TRON<br>BNB<br>IoTeX<br>Polygon<br>AVAX<br>ARBITRUM<br>BTC<br>Optimism<br>Base<br>zkSync<br>Merlin<br>Toncoin<br>Solana<br>LTC<br>DOGE<br>BCH<br>HSK<br>Sui</td></tr><tr><td>address</td><td>string</td><td>The address to check for address labels</td></tr></tbody></table>

### Response Example

```json
{
    "jsonrpc": "2.0",
    "result": {
        "label_list": [
            "Binance",
            "hot"
        ],
        "label_type": "exchange"
    },
    "id": 1
}
```

## Address Risk Score RPC

### Request Example

{% code overflow="wrap" %}

```json
{"jsonrpc": "2.0", "id": 1, "method": "mt_addressRiskScore", "params": ["ETH", "0x9225ce4129f21ae0369a21f8c056c70a7d31e831"]}
```

{% endcode %}

<table><thead><tr><th width="140.4765625">Parameter</th><th width="96.4296875">Type</th><th>Description</th></tr></thead><tbody><tr><td>blockchain</td><td>string</td><td>All optional values:<br>ETH<br>TRON<br>BNB<br>IoTeX<br>Polygon<br>AVAX<br>ARBITRUM<br>BTC<br>Optimism<br>Base<br>zkSync<br>Merlin<br>Toncoin<br>Solana<br>LTC<br>DOGE<br>BCH<br>HSK<br>Sui</td></tr><tr><td>address</td><td>string</td><td>The address to check for address labels</td></tr></tbody></table>

### Response Example

```json
{
    "jsonrpc": "2.0",
    "result": {
        "score": 51,
        "hacking_event": "",
        "detail_list": [
            "Interact With Suspected Malicious Address",
            "Interact With High-risk Tag Addresses",
            "Interact With Medium-risk Tag Addresses"
        ],
        "risk_level": "Low"
    },
    "id": 1
}
```

#### Risk Descriptions For `detail_list`

[Click here](/api-endpoints/get-risk-score-async-api#risk-descriptions-for-detail_list)

#### Risk Level Guide

[Click here](/api-endpoints/get-risk-score-async-api#risk-level-guide)


# Sandbox API

The Sandbox API returns predefined risk score results for integration testing.

Base URL:

```
https://sandbox-api.misttrack.io
```

### Authentication and Limits

All endpoints require `api_key`.

| Limit      | Value                    |
| ---------- | ------------------------ |
| Per second | 10 requests / API key    |
| Per day    | 10000 requests / API key |

Supported `coin` values:

<table><thead><tr><th width="89.078125">Coin</th><th width="345.03125">Level Coverage</th><th>Sample Count</th></tr></thead><tbody><tr><td>ETH</td><td><code>Severe</code>, <code>High</code>, <code>Moderate</code>, <code>Low</code></td><td>5</td></tr><tr><td>TRX</td><td><code>Severe</code>, <code>High</code>, <code>Moderate</code>, <code>Low</code></td><td>5</td></tr></tbody></table>

The `coin` value must match the sandbox target. ETH targets use `0x...` addresses or transaction hashes. TRX targets use `T...` addresses or 64-character transaction hashes without the `0x` prefix.

### 1. Get Risk Score

Returns the risk score result for a sandbox address or transaction hash.

```shell
GET https://sandbox-api.misttrack.io/v3/risk_score
```

#### Query Parameters

<table><thead><tr><th width="138.01953125">Parameter</th><th width="106.171875">Type</th><th width="125.16796875">Required</th><th>Description</th></tr></thead><tbody><tr><td>coin</td><td>string</td><td>yes</td><td>Supported values: <code>ETH</code>, <code>TRX</code>.</td></tr><tr><td>address</td><td>string</td><td>conditional</td><td>Sandbox address to query. Required when <code>txid</code> is empty.</td></tr><tr><td>txid</td><td>string</td><td>conditional</td><td>Sandbox transaction hash to query. Required when <code>address</code> is empty.</td></tr><tr><td>api_key</td><td>string</td><td>yes</td><td>Sandbox API key.</td></tr></tbody></table>

#### Request Example: Address

```shell
curl --location 'https://sandbox-api.misttrack.io/v3/risk_score?coin=ETH&address=0xadaf27611952c35de3ac46412225bc8cec66e2b6&api_key=YourApiKey'
```

#### Request Example: Transaction Hash

```shell
curl --location 'https://sandbox-api.misttrack.io/v3/risk_score?coin=ETH&txid=0x49a063b6f1c624f1c914241af8ecd1237fc09104987ea9c904eebfee74787a0b&api_key=YourApiKey'
```

```shell
curl --location 'https://sandbox-api.misttrack.io/v3/risk_score?coin=TRX&txid=3aa550c861c47bd955634126072e460965267ef424e4088a68d9c5368e03d789&api_key=YourApiKey'
```

#### Response Example

```json
{
  "success": true,
  "msg": "",
  "data": {
    "score": 100,
    "hacking_event": "",
    "detail_list": [
      "Malicious Address",
      "Involved Theft Activity"
    ],
    "risk_level": "Severe",
    "risk_detail": [
      {
        "entity": "Theft",
        "volume": 0,
        "percent": 100,
        "risk_type": "illicit_activity",
        "hop_num": 1,
        "exposure_type": "direct"
      }
    ],
    "address_label": "hyperunit.xyz",
    "risk_report_url": "https://light.misttrack.io/riskReport/0xadaf27611952c35de3ac46412225bc8cec66e2b6?token=8baa8563-1811-4b26-913b-337b696116ac"
  }
}
```

### 2. Create Risk Score Task

Creates a sandbox async task. In sandbox mode, known cases return `has_result: true` immediately.

```shell
POST https://sandbox-api.misttrack.io/v3/risk_score_create_task
```

#### Request Header

| Header       | Value            |
| ------------ | ---------------- |
| Content-Type | application/json |

#### Request Body

<table><thead><tr><th width="118.99609375">Parameter</th><th width="97.953125">Type</th><th width="123.19921875">Required</th><th>Description</th></tr></thead><tbody><tr><td>coin</td><td>string</td><td>yes</td><td>Supported values: <code>ETH</code>, <code>TRX</code>.</td></tr><tr><td>address</td><td>string</td><td>conditional</td><td>Sandbox address to query. Required when <code>txid</code> is empty.</td></tr><tr><td>txid</td><td>string</td><td>conditional</td><td>Sandbox transaction hash to query. Required when <code>address</code> is empty.</td></tr><tr><td>direction</td><td>string</td><td>no</td><td>Optional for transaction hash tasks. Default: <code>deposit</code>.</td></tr><tr><td>api_key</td><td>string</td><td>yes</td><td>Sandbox API key.</td></tr></tbody></table>

#### Request Example

```shell
curl --location 'https://sandbox-api.misttrack.io/v3/risk_score_create_task' \
  --header 'Content-Type: application/json' \
  --data '{
    "coin": "TRX",
    "address": "TEvwn7VF4KWfWfUSKipy6mFgjxPREPwFk2",
    "api_key": "YourApiKey"
  }'
```

#### Response Example

```json
{
  "success": true,
  "msg": "",
  "data": {
    "scanned_ts": 1782360000,
    "has_result": true,
    "task_id": "fb4446aadfe0c2daf2181306c2f4434e78842b22a3a2dbfb3c2095331ade2cfc"
  }
}
```

### 3. Query Risk Score Task

Retrieves the result of a sandbox task by `task_id`.

```shell
GET https://sandbox-api.misttrack.io/v3/risk_score_query_task
```

#### Query Parameters

<table><thead><tr><th width="120.24609375">Parameter</th><th width="102.35546875">Type</th><th width="109">Required</th><th>Description</th></tr></thead><tbody><tr><td>task_id</td><td>string</td><td>yes</td><td>Task id returned by <code>/v3/risk_score_create_task</code>.</td></tr><tr><td>api_key</td><td>string</td><td>yes</td><td>Sandbox API key.</td></tr></tbody></table>

#### Request Example

```shell
curl --location 'https://sandbox-api.misttrack.io/v3/risk_score_query_task?task_id=fb4446aadfe0c2daf2181306c2f4434e78842b22a3a2dbfb3c2095331ade2cfc&api_key=YourApiKey'
```

#### Response

The response format is the same as `/v3/risk_score`.

### Response Fields

<table><thead><tr><th width="192.78125">Parameter</th><th width="106.86328125">Type</th><th>Description</th></tr></thead><tbody><tr><td>success</td><td>bool</td><td>Whether the request succeeded.</td></tr><tr><td>msg</td><td>string</td><td>Empty on success. Contains an error code on failure.</td></tr><tr><td>data.score</td><td>int</td><td>Risk score.</td></tr><tr><td>data.hacking_event</td><td>string</td><td>Related security event or incident name.</td></tr><tr><td>data.detail_list</td><td>list</td><td>Risk descriptions.</td></tr><tr><td>data.risk_level</td><td>string</td><td>Risk level: <code>Low</code>, <code>Moderate</code>, <code>High</code>, or <code>Severe</code>.</td></tr><tr><td>data.risk_detail</td><td>list</td><td>Risk calculation details.</td></tr><tr><td>data.address_label</td><td>string</td><td>Address label. Empty string means no label.</td></tr><tr><td>data.risk_report_url</td><td>string</td><td>MistTrack risk report URL.</td></tr></tbody></table>

#### `risk_detail` Fields

<table><thead><tr><th width="172.890625">Parameter</th><th width="120.5078125">Type</th><th>Description</th></tr></thead><tbody><tr><td>entity</td><td>string</td><td>Risk entity name.</td></tr><tr><td>risk_type</td><td>string</td><td>Risk type, for example <code>illicit_activity</code> or <code>risk_exchange</code>.</td></tr><tr><td>volume</td><td>float</td><td>Transaction amount related to the risk entity.</td></tr><tr><td>percent</td><td>float</td><td>Percentage of total transaction amount.</td></tr><tr><td>hop_num</td><td>int</td><td>Hop count to the risk entity.</td></tr><tr><td>exposure_type</td><td>string</td><td><code>direct</code> or <code>indirect</code>.</td></tr><tr><td>hop_dic</td><td>object</td><td>Path details by hop. This field is only present for some indirect cases.</td></tr></tbody></table>

### Error Responses

<table><thead><tr><th width="129.6796875">HTTP Status</th><th>Response</th><th>Meaning</th></tr></thead><tbody><tr><td>400</td><td><code>{"success": false, "msg": "InvalidApiKey"}</code></td><td>Missing or invalid API key.</td></tr><tr><td>400</td><td><code>{"success": false, "msg": "InvalidParameter"}</code></td><td>Unsupported <code>coin</code>, unknown sandbox target, mismatched <code>coin</code> and target, or invalid parameter.</td></tr><tr><td>400</td><td><code>{"success": false, "msg": "InvalidAddress"}</code></td><td>Both <code>address</code> and <code>txid</code> are empty.</td></tr><tr><td>429</td><td><code>{"success": false, "msg": "ExceededRateLimit", "retry_after": 1}</code></td><td>Per-second rate limit exceeded.</td></tr><tr><td>429</td><td><code>{"success": false, "msg": "ExceededDailyRateLimit", "retry_after": 123}</code></td><td>Daily rate limit exceeded.</td></tr><tr><td>200</td><td><code>{"success": false, "msg": "TaskNotFound"}</code></td><td>Invalid task id or unsupported task target.</td></tr></tbody></table>

### Available Sandbox Targets

Use the `coin` value shown in the table when requesting each target.

<table><thead><tr><th width="84.125">Coin</th><th width="90.625">Type</th><th width="179.43359375">Target</th><th width="108.5">Risk Level</th><th width="89.87890625">Score</th><th>Detail List</th></tr></thead><tbody><tr><td>ETH</td><td>address</td><td><code>0xadaf27611952c35de3ac46412225bc8cec66e2b6</code></td><td>Severe</td><td>100</td><td>Malicious Address, Involved Theft Activity</td></tr><tr><td>ETH</td><td>address</td><td><code>0xa7cbb8fbc7a1339d1e8001f1c40491f4512547ec</code></td><td>High</td><td>85</td><td>Suspected Malicious Address, Involved Theft Activity</td></tr><tr><td>ETH</td><td>address</td><td><code>0xfc1c828f44a907f8b5807b1ca4576629abc152f1</code></td><td>Moderate</td><td>34</td><td>Involved Illicit Activity, Interact With Medium-risk Tag Addresses</td></tr><tr><td>ETH</td><td>address</td><td><code>0x2ae2182f745b10ab9c11ddaace4028930cc63e93</code></td><td>Low</td><td>3</td><td>-</td></tr><tr><td>ETH</td><td>txid</td><td><code>0x49a063b6f1c624f1c914241af8ecd1237fc09104987ea9c904eebfee74787a0b</code></td><td>Severe</td><td>96</td><td>Involved Illicit Activity</td></tr><tr><td>TRX</td><td>address</td><td><code>TGJ6QtCbQXo8Q5EAaJm3944B6MTpEvbwTB</code></td><td>Severe</td><td>100</td><td>Malicious Address, Involved Theft Activity</td></tr><tr><td>TRX</td><td>address</td><td><code>TEvwn7VF4KWfWfUSKipy6mFgjxPREPwFk2</code></td><td>High</td><td>89</td><td>Involved Illicit Activity</td></tr><tr><td>TRX</td><td>address</td><td><code>TQp6K2nHpqdk5d6q8VjAYLvp1ufUKVpsts</code></td><td>Moderate</td><td>69</td><td>Involved Illicit Activity</td></tr><tr><td>TRX</td><td>address</td><td><code>TBTwgFxL4KwAzQmMAS2L13YHy58DW6zq7e</code></td><td>Low</td><td>3</td><td>Involved Illicit Activity</td></tr><tr><td>TRX</td><td>txid</td><td><code>3aa550c861c47bd955634126072e460965267ef424e4088a68d9c5368e03d789</code></td><td>Moderate</td><td>49</td><td>Involved Illicit Activity, Interact With High-risk Tag Address, Interact With Medium-risk Tag Addresses</td></tr></tbody></table>


# Get API Status

Returns API status.

#### HTTP Request

```shell
GET https://openapi.misttrack.io/v1/status
```

> Try this endpoint in your [browser](https://openapi.misttrack.io/v1/status) 🔗

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

None
{% endtab %}

{% tab title="Response" %}
Sample Response

```json
{
    "success": true, 
    "msg": "", 
    "data": {
        "support_api": [
            "status", 
            "address_labels", 
            "risk_score", 
            "transactions_investigation", 
            "address_overview", 
            "address_action", 
            "address_trace"
        ], 
        "support_coin": [
            "ETH", 
            "USDT-ERC20", 
            "USDC-ERC20", 
            "USDT-TRC20", 
            "WETH-ERC20", 
            "BNB-ERC20", 
            "UNI-ERC20", 
            "BUSD-ERC20", 
            "DAI-ERC20", 
            "GRT-ERC20", 
            "ENS-ERC20", 
            "UST-ERC20", 
            "BNB", 
            "BUSD-BEP20", 
            "USDT-BEP20", 
            "WBNB-BEP20", 
            "ETH-BEP20", 
            "BTCB-BEP20", 
            "DOGE-BEP20", 
            "USDC-BEP20", 
            "SHIB-BEP20", 
            "UST-BEP20", 
            "POL-Polygon", 
            "WMATIC-Polygon", 
            "WETH-Polygon", 
            "USDC-Polygon", 
            "USDT-Polygon", 
            "DAI-Polygon", 
            "WBTC-Polygon", 
            "AAVE-Polygon", 
            "LINK-Polygon", 
            "UNI-Polygon", 
            "UST-Polygon", 
            "SUSHI-Polygon", 
            "MATIC-Polygon", 
            "renBTC-ERC20", 
            "WBTC-ERC20", 
            "TUSD-ERC20", 
            "SHIB-ERC20", 
            "LINK-ERC20", 
            "BAT-ERC20", 
            "CRO-ERC20", 
            "SUSHI-ERC20", 
            "stETH-ERC20", 
            "CRV-ERC20", 
            "CVX-ERC20", 
            "cvxCRV-ERC20", 
            "3Crv-ERC20", 
            "LOOKS-ERC20", 
            "USDC-TRC20", 
            "IOTX-ERC20", 
            "IOTX", 
            "VITA-IoTeX", 
            "USDT-IoTeX", 
            "BUSD_b-IoTeX", 
            "WIOTX-IoTeX", 
            "CIOTX-IoTeX", 
            "CYC-IoTeX", 
            "BNB-IoTeX", 
            "USDC-IoTeX", 
            "ETH-IoTeX", 
            "GFT-IoTeX", 
            "AVAX-Avalanche", 
            "WAVAX-Avalanche", 
            "BTC.b-Avalanche", 
            "USDT-Avalanche", 
            "USDT.e-Avalanche", 
            "USDC-Avalanche", 
            "USDC.e-Avalanche", 
            "WETH.e-Avalanche", 
            "DAI.e-Avalanche", 
            "WBTC.e-Avalanche", 
            "ETH-Arbitrum", 
            "USDT-Arbitrum", 
            "USDC.e-Arbitrum", 
            "WETH-Arbitrum", 
            "DAI-Arbitrum", 
            "WBTC-Arbitrum", 
            "LINK-Arbitrum", 
            "GMX-Arbitrum", 
            "sbfGMX-Arbitrum", 
            "STG-Arbitrum", 
            "MAGIC-Arbitrum", 
            "USDC-Arbitrum", 
            "BTC", 
            "DAI-BEP20", 
            "Cake-BEP20", 
            "APE-ERC20", 
            "ARB-Arbitrum", 
            "ETH-Optimism", 
            "USDT-Optimism", 
            "USDC-Optimism", 
            "OP-Optimism", 
            "DAI-Optimism", 
            "WBTC-Optimism", 
            "WETH-Optimism", 
            "SNX-Optimism", 
            "sUSD-Optimism", 
            "VELO-Optimism", 
            "USDC.e-Optimism", 
            "PYUSD-ERC20", 
            "ETH-Base", 
            "TRX", 
            "MEME-ERC20", 
            "ETH-zkSync", 
            "USDC.e-Polygon", 
            "BTC-Merlin", 
            "BCH-BEP20", 
            "USDC-Base", 
            "USDbC-Base", 
            "WETH-Base", 
            "DEGEN-Base", 
            "DAI-Base", 
            "cbETH-Base", 
            "TON", 
            "ZK-zkSync", 
            "WLD-Optimism", 
            "USDT-TON", 
            "SOL", 
            "USDT-Solana", 
            "USDC-Solana", 
            "LTC", 
            "DOGE", 
            "BCH", 
            "Bonk-Solana", 
            "JUP-Solana", 
            "RAY-Solana", 
            "PYTH-Solana", 
            "W-Solana", 
            "WUSD-ERC20", 
            "WUSD-Polygon", 
            "USDT-Base", 
            "WBTC-Base", 
            "USDS-Base", 
            "wstETH-Base", 
            "USDe-Base", 
            "LINK-Base", 
            "cbBTC-Base", 
            "AAVE-Base", 
            "LBTC-Base", 
            "OM-Base", 
            "rETH-Base", 
            "CRV-Base", 
            "SolvBTC-Base", 
            "USDS-Arbitrum", 
            "PEPE-ERC20", 
            "cbBTC-ERC20", 
            "FLOKI-ERC20", 
            "LEO-ERC20", 
            "USDS-ERC20", 
            "FDUSD-ERC20", 
            "USDe-ERC20",
            "USDD-TRC20",
            "USD1-ERC20",
            "USD1-BEP20",
            "HSK",
            "WLFI-ERC20",
            "WLFI-Solana",
            "SUI",
            "wUSDT-SUI",
            "USDC-SUI",
            "TRUMP-Solana",
            "USDT-zkSync",
            "USDC-zkSync",
            "BUSD-Solana",
            "PYUSD-Solana",
            "USDS-Solana",
            "FDUSD-Solana",
            "DAI-Solana",
            "BUSD-Polygon",
            "TUSD-BEP20",
            "USDe-BEP20",
            "FDUSD-BEP20",
            "sUSD-ERC20",
            "USDe-Optimism",
            "USDe-Arbitrum",
            "FDUSD-Arbitrum",
            "EURCV-ERC20",
            "EURI-ERC20",
            "EURI-BEP20",
            "USDG-ERC20",
            "USDG-Solana",
            "EURC-Base",
            "EURC-Solana",
            "EURC-Avalanche",
            "EURC-ERC20"
        ]
    }
}
```

{% endtab %}
{% endtabs %}


# Get Address Labels

Returns a list of labels for a given address.

#### HTTP Request

```shell
GET https://openapi.misttrack.io/v1/address_labels
   ?coin=ETH
   &address=0x8894E0a0c962CB723c1976a4421c95949bE2D4E3
   &api_key=YourApiKey
```

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

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

<table><thead><tr><th width="167.66666666666666">Parameter</th><th width="141">Type</th><th>Description</th></tr></thead><tbody><tr><td>coin</td><td>string</td><td>the coin to check for address labels, <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 address labels</td></tr><tr><td>api_key</td><td>string</td><td>your api key</td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

<table><thead><tr><th width="131.99609375">Field</th><th width="95.65625">Type</th><th>Description</th></tr></thead><tbody><tr><td>label_list</td><td>list</td><td><p>The address label data includes the following:<br></p><ul><li>entity name, eg: Coinbase, Binance</li><li>address label type, eg: deposit, hot, cold wallet</li><li>on-chain tags, eg: ENS name, MEV Bots, DeFi Whales</li><li>off-chain tags, eg: MetaMask Wallet User, Twitter handle</li></ul><p><a href="https://docs.google.com/document/d/1R77MToe09Mbz5nQAexjeNc_me3bGxaJaPP0wxsY9Xf0/edit?tab=t.0#heading=h.ajo97k55hwxk">More examples here.</a></p></td></tr><tr><td>label_type</td><td>string</td><td><p>Include following types:</p><p></p><ul><li><code>exchange</code>, it represents centralized exchanges, payment platforms, crypto asset custodians, and various centralized services.</li><li><code>defi</code>, it represents DeFi projects, cross-chain bridges.</li><li><code>mixer</code>, it means it is a coin mixer or an instant exchange platform that does not require KYC.</li><li><code>nft</code>, it represents NFT marketplace.</li><li>empty value, it represents an unclassified tag.</li></ul></td></tr></tbody></table>

Sample Response

```json
{
    "success": true, 
    "msg": "", 
    "data": {
        "label_list": [
            "Binance", 
            "hot"
        ], 
        "label_type": "exchange"
    }
}
```

{% endtab %}
{% endtabs %}

#### [Rate Limits](/openapi/overview#rate-limits)


# Get Address Overview

Returns the balance and statistics for a given address.

#### HTTP Request

```shell
GET https://openapi.misttrack.io/v1/address_overview
   ?coin=ETH
   &address=0xab5801a7d398351b8be11c439e05c5b3259aec9b
   &api_key=YourApiKey
```

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

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

<table><thead><tr><th width="150.66666666666666">Parameter</th><th width="142">Type</th><th>Description</th></tr></thead><tbody><tr><td>coin</td><td>string</td><td>the coin to check for overview datas, <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 overview datas</td></tr><tr><td>api_key</td><td>string</td><td>your api key</td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

<table><thead><tr><th width="209.66666666666666">Field</th><th width="112">Type</th><th>Description</th></tr></thead><tbody><tr><td>balance</td><td>float(4)</td><td>The balance of the query address</td></tr><tr><td>txs_count</td><td>int</td><td>Total number of transactions of the query address</td></tr><tr><td>first_seen</td><td>int</td><td>The first transaction time of the query address, in unix timestamp format</td></tr><tr><td>last_seen</td><td>int</td><td>The last transaction time of the query address, in unix timestamp format</td></tr><tr><td>total_received</td><td>float(4)</td><td>The total received amount of the query address</td></tr><tr><td>total_spent</td><td>float(4)</td><td>The total spent amount of the query address</td></tr><tr><td>received_txs_count</td><td>int</td><td>Total number of incoming transactions of the query address</td></tr><tr><td>spent_txs_count</td><td>int</td><td>Total number of outgoing transactions of the query address</td></tr></tbody></table>

Sample Response

```json
{
        "success": true, 
        "msg": "", 
        "data": {
                "balance": 49.8305, 
                "txs_count": 1231, 
                "first_seen": 1441800674,
                "last_seen": 1670971955,
                "total_received": 916204.8697, 
                "total_spent": 916151.0499, 
                "received_txs_count": 1018, 
                "spent_txs_count": 213
        }
}
```

{% endtab %}
{% endtabs %}

#### [Rate Limits](https://docs.misttrack.io/openapi/overview#rate-limits)


# 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

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

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

> Try this endpoint in your [browser](https://openapi.misttrack.io/v3/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="/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>direction</td><td>string</td><td>optional values: <code>deposit</code>, <code>withdraw</code> , default: <code>deposit</code><br>Indicates transaction direction when <code>txid</code> is provided.</td></tr><tr><td>api_key</td><td>string</td><td>your api key</td></tr></tbody></table>

{% hint style="info" %}
Provide either `address` or `txid` as the target. Do not 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 of the queried address. Range: 3–100.</td></tr><tr><td>hacking_event</td><td>string</td><td>Related security incident associated with the address (if any).</td></tr><tr><td>detail_list</td><td>list</td><td>List of risk indicators associated with the 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>Detailed breakdown of risk exposures used in score calculation.</td></tr><tr><td>address_label</td><td>string</td><td>Entity label of the queried address.<br>When <code>txid</code> and <code>direction</code> are provided, this refers to the label of the from or to address in the transaction.</td></tr><tr><td>risk_report_url</td><td>string</td><td>URL to download the MistTrack AML risk report (PDF) for this 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>Name of the associated risk entity (e.g., 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>Number of hops between the queried address and the risk entity. Minimum value: 1.</td></tr><tr><td>hop_dic</td><td>dict</td><td>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.</td></tr><tr><td>volume</td><td>float</td><td>Total transaction volume associated with the risk entity (in USD).</td></tr><tr><td>percent</td><td>float</td><td>Proportion of this risk exposure relative to the total transaction volume.</td></tr></tbody></table>

Sample Response

```json
{
  "success": true,
  "msg": "",
  "data": {
    "score": 75,
    "hacking_event": "",
    "detail_list": [
      "Involved Illicit Activity",
      "Interact With High-risk Tag Address"
    ],
    "risk_level": "High",
    "risk_detail": [
      {
        "entity": "huionepay",
        "risk_type": "sanctioned_entity",
        "volume": 2373.904,
        "hop_num": 2,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "huionepay"
          ],
          "2": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "3": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 45.652
      },
      {
        "entity": "www.hwdb.la",
        "risk_type": "sanctioned_entity",
        "volume": 113.674,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "www.hwdb.la"
          ],
          "2": [
            "THGBqCF4usjVB86zUuX9fiSwqQxaVUSRkB"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 2.186
      },
      {
        "entity": "xinbi guarantee",
        "risk_type": "sanctioned_entity",
        "volume": 30.874,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "xinbi guarantee"
          ],
          "2": [
            "TPZpqQpkV35Y1YXuYDJsZZkiEefCrrGGfA"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 0.594
      },
      {
        "entity": "USDT Banned Address",
        "risk_type": "illicit_activity",
        "volume": 22.372,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "TNXubajgkYKmQ2rCG3oqR3HDjYZWZJYxxg"
          ],
          "2": [
            "TENjUs6TYuxjmQxMBkP9g2cg9Ug5mJrWCz"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 0.43
      },
      {
        "entity": "Illegal Services",
        "risk_type": "illicit_activity",
        "volume": 10.296,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "TUfBKrEKh58QYGTCkfSBj8zYP9iHK9KXTW"
          ],
          "2": [
            "TUJBPo6rGCnGEsfuSRgQ585GE28ydu1Ef5"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 0.198
      },
      {
        "entity": "Guarantee Merchant",
        "risk_type": "illicit_activity",
        "volume": 7.476,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "TMrtQHj7C2QmSG3YqwN3Kdv4MxeBJpfTV5"
          ],
          "2": [
            "TENjUs6TYuxjmQxMBkP9g2cg9Ug5mJrWCz"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 0.144
      },
      {
        "entity": "Phishing",
        "risk_type": "illicit_activity",
        "volume": 5.429,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "TKt83wLwr7dB8NoF5D61Yd1fdmvPWEbiav"
          ],
          "2": [
            "TUJ7Whcypxfapp1riCTXHS9gewh8uqQea9"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 0.104
      },
      {
        "entity": "DGCX(Xinkangjia) Scam",
        "risk_type": "illicit_activity",
        "volume": 5.334,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "TJsboummq5ipC4PRigGuW7zi2TUK5PHhFN"
          ],
          "2": [
            "TTeYJS4RihjG7LyZHCBPfLvwj75mTtDf38"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 0.103
      }
    ],
    "address_label": "",
    "risk_report_url": "https://files.misttrack.io/riskReport/TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn?token=43fb70ee-76a2-40b6-95a8-d67205d96f0e"
  }
}
```

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


# Get Risk Score(Async API)

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.

<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><tr><td>risk_report_url</td><td>string</td><td>URL to download the MistTrack AML risk report (PDF) for this 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://files.misttrack.io/riskReport/TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn?token=43fb70ee-76a2-40b6-95a8-d67205d96f0e"
    }
}
```

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


# Get Risk Score(Async API) V3.0

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

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

**Parameters**

<table><thead><tr><th width="174.96484375">Parameter</th><th width="132.71484375">Type</th><th width="88.53125">Required</th><th>Description</th></tr></thead><tbody><tr><td>coin</td><td>string</td><td>yes</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>conditional</td><td>The address to check for risk score, required when <code>txid</code> is empty.</td></tr><tr><td>txid</td><td>string</td><td>conditional</td><td>The transaction hash to check for risk score, required when <code>address</code> is empty.</td></tr><tr><td>direction</td><td>string</td><td>no</td><td>Used for transaction hash queries. Optional values: <code>deposit</code>, <code>withdraw</code>. Default: <code>deposit</code>.</td></tr><tr><td>api_key</td><td>string</td><td>yes</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/v3/risk_score_create_task'
--header 'Content-Type: application/json'
--data '{
    "address": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
    "coin": "TRX",
    "api_key": "YourApiKey"
}'
```

```sh
curl --location 'https://openapi.misttrack.io/v3/risk_score_create_task'
--header 'Content-Type: application/json'
--data '{
    "txid": "c3fa08ba00eb1b59d4f2160065ab4bdea47fd50cbba0e0d48b4b11059c318d29",
    "coin": "TRX",
    "direction": "deposit",
    "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><tr><td>task_id</td><td>string</td><td>Use this value to query the task result.</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, "task_id": "fb4446aadfe0c2daf2181306c2f4434e78842b22a3a2dbfb3c2095331ade2cfc"}}
```

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:

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

You can immediately call the API `/v3/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/v3/risk_score_query_task
   ?task_id={task_id}
   &api_key=YourApiKey
```

**Parameters**

<table><thead><tr><th width="174.6484375">Parameter</th><th width="132.55078125">Type</th><th width="106.671875">Required</th><th>Description</th></tr></thead><tbody><tr><td>task_id</td><td>string</td><td>yes</td><td>The task id returned by <code>/v3/risk_score_create_task</code>.</td></tr><tr><td>api_key</td><td>string</td><td>yes</td><td>Your API key</td></tr></tbody></table>

**Response Parameters**

* The task is not completed.

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

* The task was not found.

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

* The task has been completed.

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

<table><thead><tr><th width="142.64453125">Parameter</th><th width="97.07421875">Type</th><th>Description</th></tr></thead><tbody><tr><td>score</td><td>int</td><td>Risk score of the queried address. Range: 3–100.</td></tr><tr><td>hacking_event</td><td>string</td><td>Related security incident associated with the address (if any).</td></tr><tr><td>detail_list</td><td>list</td><td>List of risk indicators associated with the address.</td></tr><tr><td>risk_level</td><td>string</td><td>Risk level, <a href="https://docs.misttrack.io/api-endpoints/get-risk-score-v3#risk-level-guide">Low / Moderate / High / Severe</a></td></tr><tr><td>risk_detail</td><td>list</td><td>Detailed breakdown of risk exposures used in score calculation.</td></tr><tr><td>address_label</td><td>string</td><td>Entity label of the queried address. When <code>txid</code> and <code>direction</code> are provided, this refers to the label of the from or to address in the transaction.</td></tr><tr><td>risk_report_url</td><td>string</td><td>URL to download the MistTrack AML risk report (PDF) for this 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>Name of the associated risk entity (e.g., 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>Number of hops between the queried address and the risk entity. Minimum value: 1.</td></tr><tr><td>hop_dic</td><td>dict</td><td>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.</td></tr><tr><td>volume</td><td>float</td><td>Total transaction volume associated with the risk entity (in USD).</td></tr><tr><td>percent</td><td>float</td><td>Proportion of this risk exposure relative to the total transaction volume.</td></tr></tbody></table>

Sample Response

```json
{
  "success": true,
  "msg": "",
  "data": {
    "score": 75,
    "hacking_event": "",
    "detail_list": [
      "Involved Illicit Activity",
      "Interact With High-risk Tag Address"
    ],
    "risk_level": "High",
    "risk_detail": [
      {
        "entity": "huionepay",
        "risk_type": "sanctioned_entity",
        "volume": 2373.904,
        "hop_num": 2,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "huionepay"
          ],
          "2": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "3": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 45.652
      },
      {
        "entity": "www.hwdb.la",
        "risk_type": "sanctioned_entity",
        "volume": 113.674,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "www.hwdb.la"
          ],
          "2": [
            "THGBqCF4usjVB86zUuX9fiSwqQxaVUSRkB"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 2.186
      },
      {
        "entity": "xinbi guarantee",
        "risk_type": "sanctioned_entity",
        "volume": 30.874,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "xinbi guarantee"
          ],
          "2": [
            "TPZpqQpkV35Y1YXuYDJsZZkiEefCrrGGfA"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 0.594
      },
      {
        "entity": "USDT Banned Address",
        "risk_type": "illicit_activity",
        "volume": 22.372,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "TNXubajgkYKmQ2rCG3oqR3HDjYZWZJYxxg"
          ],
          "2": [
            "TENjUs6TYuxjmQxMBkP9g2cg9Ug5mJrWCz"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 0.43
      },
      {
        "entity": "Illegal Services",
        "risk_type": "illicit_activity",
        "volume": 10.296,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "TUfBKrEKh58QYGTCkfSBj8zYP9iHK9KXTW"
          ],
          "2": [
            "TUJBPo6rGCnGEsfuSRgQ585GE28ydu1Ef5"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 0.198
      },
      {
        "entity": "Guarantee Merchant",
        "risk_type": "illicit_activity",
        "volume": 7.476,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "TMrtQHj7C2QmSG3YqwN3Kdv4MxeBJpfTV5"
          ],
          "2": [
            "TENjUs6TYuxjmQxMBkP9g2cg9Ug5mJrWCz"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 0.144
      },
      {
        "entity": "Phishing",
        "risk_type": "illicit_activity",
        "volume": 5.429,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "TKt83wLwr7dB8NoF5D61Yd1fdmvPWEbiav"
          ],
          "2": [
            "TUJ7Whcypxfapp1riCTXHS9gewh8uqQea9"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 0.104
      },
      {
        "entity": "DGCX(Xinkangjia) Scam",
        "risk_type": "illicit_activity",
        "volume": 5.334,
        "hop_num": 3,
        "exposure_type": "indirect",
        "hop_dic": {
          "1": [
            "TJsboummq5ipC4PRigGuW7zi2TUK5PHhFN"
          ],
          "2": [
            "TTeYJS4RihjG7LyZHCBPfLvwj75mTtDf38"
          ],
          "3": [
            "TExZLkqhytVwJ3Dbcsp16u91f2oFTD1VEQ"
          ],
          "4": [
            "TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn"
          ]
        },
        "percent": 0.103
      }
    ],
    "address_label": "",
    "risk_report_url": "https://files.misttrack.io/riskReport/TU9SQJFv8imPtuuFesyAdwM1GVJTjBwFmn?token=43fb70ee-76a2-40b6-95a8-d67205d96f0e"
  }
}
```

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


# 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 associated with the given address. All assets on the same blockchain will return the same result regardless of the coin parameter.

#### 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="/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" %}
Provide either `address` or `txid` as the target. Do not 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 of the queried address. Range: 3–100.</td></tr><tr><td>hacking_event</td><td>string</td><td>Related security incident associated with the address (if any).</td></tr><tr><td>detail_list</td><td>list</td><td>List of risk indicators associated with the 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>Detailed breakdown of risk exposures used in score calculation.</td></tr><tr><td>risk_report_url</td><td>string</td><td>URL to download the MistTrack AML risk report (PDF) for this 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>Name of the associated risk entity (e.g., 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>Number of hops between the queried address and the risk entity. Minimum value: 1.</td></tr><tr><td>volume</td><td>float</td><td>Total transaction volume associated with the risk entity (in USD).</td></tr><tr><td>percent</td><td>float</td><td>Proportion of this risk exposure relative to the total transaction volume.</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://files.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>


# Get Risk Score(v1.old)

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/v1/risk_score
   ?coin=ETH
   &address={address}
   &txid={txn hash}
   &api_key=YourApiKey
```

> Try this endpoint in your [browser](https://openapi.misttrack.io/v1/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="/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 %}
{% 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><p>Data for the risk score calculation process.</p><p></p><p><code>type</code> values:</p><ul><li>malicious</li><li>suspected_malicious</li><li>high_risk</li><li>medium_risk</li></ul></td></tr></tbody></table>

Sample Response

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

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


# Get Transactions Investigation

Returns transaction investigation results for a given address.

#### HTTP Request

```shell
GET https://openapi.misttrack.io/v1/transactions_investigation
   ?coin=ETH
   &address=0xb3065fe2125c413e973829108f23e872e1db9a6b
   &api_key=YourApiKey
```

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

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

<table><thead><tr><th width="185.66666666666666">Parameter</th><th width="112">Type</th><th>Description</th></tr></thead><tbody><tr><td>coin</td><td>string</td><td>the coin to check for transaction investigation, <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 transaction investigation</td></tr><tr><td>api_key</td><td>string</td><td>your api key</td></tr><tr><td>start_timestamp</td><td>int</td><td>the start timestamp to check for transaction investigation(optional, default is 0)</td></tr><tr><td>end_timestamp</td><td>int</td><td>the end timestamp to check for transaction investigation(optional, default is current timestamp)</td></tr><tr><td>type</td><td>string</td><td>the type to check for transaction investigation(optional value "in", "out" and "all", default is "all")</td></tr><tr><td>page</td><td>int</td><td>page number(optional, default is 1)</td></tr></tbody></table>
{% endtab %}

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

<table><thead><tr><th width="237">Parameter</th><th width="83.66666666666666">Type</th><th>Description</th></tr></thead><tbody><tr><td>in</td><td>list</td><td>The transfer-in transaction list of the querying address</td></tr><tr><td>out</td><td>list</td><td>The transfer-out transaction list of the querying address</td></tr><tr><td>page</td><td>int</td><td>The current page number</td></tr><tr><td>total_pages</td><td>int</td><td>The total page number</td></tr><tr><td>transactions_on_page</td><td>int</td><td>The number of transactions investigated on the current page(maximum is 1000)</td></tr></tbody></table>

Response Data Unit Parameters

<table><thead><tr><th width="191.66666666666666">Parameter</th><th width="145">Type</th><th>Description</th></tr></thead><tbody><tr><td>address</td><td>string</td><td>address that have a transfer relationship with the querying address</td></tr><tr><td>type</td><td>int</td><td><p>1: EOA address / bitcoin address, </p><p>2: malicious address, </p><p>3: entity label address,</p><p>4: contract address</p></td></tr><tr><td>tx_hash_list</td><td>list</td><td>transfer transaction hash list</td></tr><tr><td>amount</td><td>float(4)</td><td>total transfer amount</td></tr><tr><td>label</td><td>string</td><td>address label detail</td></tr></tbody></table>

Sample Response

```json
{
	"success": true,
	"msg": "",
	"data": {
		"out": [
			{
				"address": "0xd90e2f925da726b50c4ed8d0fb90ad053324f31b",
				"tx_hash_list": [
					"0x48c2601bcb2f3cc5a4b047d0151322d74b525c79fc68a052ba6e7faf1231017c",
					"0x7e87c61d423a3ea98937c16e4519069410212b16b6614daa9a84110a7422a12a",
					"0x9b8b6c6a141476fd7727a3e89fab94bd14638149430cb2512d7f0c6e731ab4ad",
					"0x6cba946ea79e77592a5a2dda2cd2a0806f568fae4f5f129624a621c7b36b8698",
					"0x8c558551d9b56e5643235d9dfe3865ce78b77630f789b1b7b02f7927ffd4b5b6",
					"0x5a2a96e722ce113fd22a919b08f51b2d49ab7b90784c2b11386380093e6c4d99",
					"0xaec81680d2bb4c8dbfbf150edb92abb618ef345c3325e62c0472b14f84e3a4ae",
					"0xf1b495be2beb828b88d6b60afd613bc9c7eadd9a7b51b98f03d48809f1136bfb",
					"0xefe8a14dfca2394b5ef914e9e0c3f83a07c83dc4eaf3187769384744d746cdf3",
					"0x0e4be586fe14b3aa2585fe3af0fa69cc5f3092c11d1e398987df46b28daa7ab3",
					"0xb2c5dcb6c2af88b2d139c575f7e575e8fd70bc225de72c99a142c9540a406635",
					"0x979711c7760844ca0cc5c04436676e12c0c3d9d8f4abe429fa2b5b8b21c685dc",
					"0x91cca8652cd00559fd0ff63557a967a14c13507d90e35acb4e71d8aed9fa65b8",
					"0x2acf21485518c305d40da718a415519c8c4fecf43323f45a2a945f400083d9fe"
				],
				"amount": 743,
				"type": 3,
				"label": "Tornado.Cash: Router"
			},
			{
				"address": "0x7e46480d8e28c1d6c55be1b782084dd2c902f99f",
				"tx_hash_list": [
					"0xf3ba8038e1e22017a91efa5d87685891b90f081a1da4f5098c8c7c8d97519e85"
				],
				"amount": 0.0845,
				"type": 1,
				"label": ""
			},
			{
				"address": "0x259838b05d61717e37fc7b6bf0758d25644ee930",
				"tx_hash_list": [
					"0xaa5eccb2fa452770e5a4026d8b335c8a292e7166832116c3e6494c384dc3ec87"
				],
				"amount": 0.0795,
				"type": 3,
				"label": "binance"
			},
			{
				"address": "0xf8dfe4da86f8e73fec7383784f96752255d50fdc",
				"tx_hash_list": [
					"0x5e58958244228e3954550f5dea9065b1622a29ad77821e4a1a669a01fd3e60b0"
				],
				"amount": 0.0428,
				"type": 1,
				"label": ""
			},
			{
				"address": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45",
				"tx_hash_list": [
					"0x1854e70f60ca81ada0d842242cfc34fbb2a107e825389cb24485733d1a3bda5c",
					"0xf620d29dd717035ed94e6c325b28d5ed2ac173022a0577463a9c9d4c1ce1a10a"
				],
				"amount": 0.65,
				"type": 3,
				"label": "Uniswap V3: Router 2"
			},
			{
				"address": "0xd32998321e43fcdb0482101a7aed9496813e06d0",
				"tx_hash_list": [
					"0x2e565664bb8b29a3930207a2df2f46045c4c0eba8882c8b57cab67c35437992b",
					"0xf4b19bde3035c0a1a4bef62132b8c1f1577b3910d32718bad9e5261f60194833",
					"0x6a939a4dbf30a1f291e4fa9ba010294226acdad7a4fd8a6010b94ca1694515f4",
					"0x8eba59c2632d55a99324b2a2d218dba64b40e6a2ed32f0aac75c29f53203dfcd",
					"0x264e5295660cc469165cb26de5e6ac2257e9f15920c6d0d5ddb8a0ca4d15a45a",
					"0xad604f2e3ba83c4dadc540919ad86077cf8d589f08f70ab1482144a5f5bb46ef"
				],
				"amount": 1.4668,
				"type": 1,
				"label": ""
			}
		],
		"in": [
			{
				"address": "0xcdd37ada79f589c15bd4f8fd2083dc88e34a2af2",
				"tx_hash_list": [
					"0x5cc3de8969e2642f6562fe3c0d32f0136a046e53f95ca1f40fe0b7e069f6646c"
				],
				"amount": 0.3615,
				"type": 3,
				"label": "sideshift.ai"
			},
			{
				"address": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45",
				"tx_hash_list": [
					"0x127fcdb6f30228045d07525940b628e9d1c2d343d4d2d79a41f078eecf67d869",
					"0x7f14257482969941aaa6fef9b27bbd48cae828c5df7c6246c8b2d9f7cfa8acbe",
					"0x5e6cad442ee522055512514616cb9465f551d81096c09b183175609db177e8da",
					"0x87032b673fa3264e491e6770209a2457ae4d765c0f504d87b4467e7e907fafaa",
					"0x33cdf3daee948390200254e8a0a0580a6b12ca813f45788c359bd389ed3bcce0",
					"0xac1139c366727e434de7ae3334d5acb95d2f0dcf3bfc43544dd768491e2e2890",
					"0x24952d8c3ec6dbf4c468518e9ff67f9d97ac9963ceb71ecab9ff58014a914ec8"
				],
				"amount": 735.5724,
				"type": 3,
				"label": "Uniswap V3: Router 2"
			},
			{
				"address": "0xd9e1ce17f2641f24ae83637ab66a2cca9c378b9f",
				"tx_hash_list": [
					"0xcbb552f4929b9ab891884189be2d885468de774d7644b53c54c21ef810b4a01d"
				],
				"amount": 0.4158,
				"type": 3,
				"label": "SushiSwap: Router"
			},
			{
				"address": "0xb3065fe2125c413e973829108f23e872e1db9a6b",
				"tx_hash_list": [
					"0x24dcf60c17a2c068549e3cfcfce8e131ff65ec0ef414218feb2c2b198b3a6280"
				],
				"amount": 0.0098,
				"type": 1,
				"label": ""
			},
			{
				"address": "0x910cbd523d972eb0a6f4cae4618ad62622b39dbf",
				"tx_hash_list": [
					"0x113be3df8e1e95cacd51d57ad1022fb7181bd19650648a346c29c540801a45a0"
				],
				"amount": 9.9364,
				"type": 3,
				"label": "Tornado.Cash: 10 ETH"
			}
		],
        "page": 1,
        "total_pages": 1,
        "transactions_on_page": 36
	}
}
```

{% endtab %}
{% endtabs %}

#### [Rate Limits](https://docs.misttrack.io/openapi/overview#rate-limits)


# Get Address Actions

Returns transaction actions analysis results for a given address.

#### HTTP Request

```shell
GET https://openapi.misttrack.io/v1/address_action
   ?coin=ETH
   &address=0xb3065fe2125c413e973829108f23e872e1db9a6b
   &api_key=YourApiKey
```

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

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

<table><thead><tr><th width="185.66666666666666">Parameter</th><th width="112">Type</th><th>Description</th></tr></thead><tbody><tr><td>coin</td><td>string</td><td>the coin to check for address actions, <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</td></tr><tr><td>api_key</td><td>string</td><td>your api key</td></tr></tbody></table>
{% endtab %}

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

<table><thead><tr><th width="237">Parameter</th><th width="83.66666666666666">Type</th><th>Description</th></tr></thead><tbody><tr><td>received_txs</td><td>list</td><td>The analysis result of the incoming transaction of the target address.</td></tr><tr><td>spent_txs</td><td>list</td><td>The analysis result of the outgoing transaction of the target address.</td></tr></tbody></table>

The API response data is suitable for display in a pie chart, as shown in the following figure.

<figure><img src="/files/hGDxqCchhh939v8Up1fl" alt=""><figcaption><p>Pie chart preview</p></figcaption></figure>

Sample Response

```json
{
    "success": true,
    "msg": "",
    "action_dic": {
        "received_txs": [
            {
                "action": "DEX",
                "count": 7,
                "proportion": 70.0
            },
            {
                "action": "Mixer",
                "count": 1,
                "proportion": 10.0
            },
            {
                "action": "Exchange",
                "count": 1,
                "proportion": 10.0
            },
            {
                "action": "Swap",
                "count": 1,
                "proportion": 10.0
            }
        ],
        "spent_txs": [
            {
                "action": "Exchange",
                "count": 15,
                "proportion": 57.69
            },
            {
                "action": "DEX",
                "count": 2,
                "proportion": 7.69
            },
            {
                "action": "Transfer",
                "count": 9,
                "proportion": 34.62
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

#### [Rate Limits](https://docs.misttrack.io/openapi/overview#rate-limits)


# Get Address Profile

This API endpoint allows users to easily track which platforms an address has interacted with, such as exchanges, mixers, DeFi protocols, and NFT platforms. It also identifies any associated malicious events and provides additional information about the address, including used wallets, ENS names, and linked Twitter profiles.

#### HTTP Request

```shell
GET https://openapi.misttrack.io/v1/address_trace
   ?coin=ETH
   &address=0xb3065fe2125c413e973829108f23e872e1db9a6b
   &api_key=YourApiKey
```

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

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

<table><thead><tr><th width="185.66666666666666">Parameter</th><th width="112">Type</th><th>Description</th></tr></thead><tbody><tr><td>coin</td><td>string</td><td>the coin to check for address profile, <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</td></tr><tr><td>api_key</td><td>string</td><td>your api key</td></tr></tbody></table>
{% endtab %}

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

<table><thead><tr><th width="237">Parameter</th><th width="83.66666666666666">Type</th><th>Description</th></tr></thead><tbody><tr><td>first_address</td><td>string</td><td>The source wallet address of the gas fee, or the label of the source address.</td></tr><tr><td>use_platform</td><td>dict</td><td>Includes four fields: <code>exchange</code>, <code>dex</code>, <code>mixer</code>,  <code>nft</code>.</td></tr><tr><td>malicious_event</td><td>dict</td><td>Includes four fields: <code>phishing</code>, <code>ransom</code>, <code>stealing</code>, <code>laundering</code>.</td></tr><tr><td>relation_info</td><td>dict</td><td>Includes three fields: <code>wallet</code>, <code>ens</code>, <code>twitter</code>.</td></tr></tbody></table>

Sample Response

```json
{
    "success": true, 
    "msg": "", 
    "data": {
        "first_address": "sideshift.ai", 
        "use_platform": {
            "exchange": {
                "count": 1, 
                "exchange_list": [
                    "Binance"
                ]
            }, 
            "dex": {
                "count": 3, 
                "dex_list": [
                    "Uniswap", 
                    "SushiSwap", 
                    "Multichain"
                ]
            }, 
            "mixer": {
                "count": 2, 
                "mixer_list": [
                    "Tornado.Cash", 
                    "sideshift.ai"
                ]
            }, 
            "nft": {
                "count": 0, 
                "nft_list": [ ]
            }
        }, 
        "malicious_event": {
            "phishing": {
                "count": 0, 
                "phishing_list": [ ]
            }, 
            "ransom": {
                "count": 0, 
                "ransom_list": [ ]
            }, 
            "stealing": {
                "count": 5, 
                "stealing_list": [
                    "MMFinance Exploiter"
                ]
            }, 
            "laundering": {
                "count": 0, 
                "laundering_list": [ ]
            }
        }, 
        "relation_info": {
            "wallet": {
                "count": 0, 
                "wallet_list": [ ]
            }, 
            "ens": {
                "count": 2, 
                "ens_list": [
                    "destruction.eth", 
                    "poma.eth"
                ]
            }, 
            "twitter": {
                "count": 1, 
                "twitter_list": [
                    " @destructioneth"
                ]
            }
        }
    }
}
```

{% endtab %}
{% endtabs %}

#### [Rate Limits](https://docs.misttrack.io/openapi/overview#rate-limits)


# Get Address Counterparty

Returns counterparty analysis results for a given address.

#### HTTP Request

```shell
GET https://openapi.misttrack.io/v1/address_counterparty
   ?coin=ETH
   &address=0xb3065fe2125c413e973829108f23e872e1db9a6b
   &api_key=YourApiKey
```

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

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

<table><thead><tr><th width="185.66666666666666">Parameter</th><th width="112">Type</th><th>Description</th></tr></thead><tbody><tr><td>coin</td><td>string</td><td>the coin to check for address counterparty, <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</td></tr><tr><td>api_key</td><td>string</td><td>your api key</td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}
The API response data is suitable for display in a pie chart, as shown in the following figure.

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

Sample Response

```json
{
    "success": true, 
    "msg": "", 
    "address_counterparty_list": [
        {
            "name": "Uniswap", 
            "amount": 4496524.699, 
            "percent": 49.678
        }, 
        {
            "name": "Tornado.Cash", 
            "amount": 2377637.58, 
            "percent": 26.268
        }, 
        {
            "name": "Multichain", 
            "amount": 2168062.159, 
            "percent": 23.953
        }, 
        {
            "name": "Unknown", 
            "amount": 5350.102, 
            "percent": 0.059
        }, 
        {
            "name": "SushiSwap", 
            "amount": 2394.385, 
            "percent": 0.026
        }, 
        {
            "name": "sideshift.ai", 
            "amount": 1141.399, 
            "percent": 0.013
        }, 
        {
            "name": "Binance", 
            "amount": 302.008, 
            "percent": 0.003
        }
    ]
}

```

{% endtab %}
{% endtabs %}

#### [Rate Limits](https://docs.misttrack.io/openapi/overview#rate-limits)


# Common Error Messages

An API call that encounters an error will return `False` as its `success` field and display the cause of the error under the `msg` field.

| Field `msg`                   | Description                                                                                                                                                                |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MaxRateLimit`     Deprecated | ~~Max rate limit reached~~                                                                                                                                                 |
| `ExceededRateLimit`           | Reached the rate limit per second                                                                                                                                          |
| `ExceededDailyRateLimit`      | Reached daily rate limit                                                                                                                                                   |
| `InvalidApiKey`               | Invalid API key                                                                                                                                                            |
| `UnsupportedToken`            | Unsupported query coin                                                                                                                                                     |
| `InvalidAddress`              | Invalid query address                                                                                                                                                      |
| `PageNotFound`                | Page not found                                                                                                                                                             |
| `ExpiredPlan`                 | Plan has expired                                                                                                                                                           |
| `TaskNotFound`                | The task cannot be found. You need to [create it](https://docs.misttrack.io/support/pages/0PAQXf7RDrWKrvRimA1T#id-1.-create-task-api) first and then query it.             |
| `UnsupportedAddressType`      | Some endpoints (such as [Address Counterparty](/api-endpoints/get-address-counterparty)) do not support analyzing hot wallet addresses and will return this error message. |
| `QuotaExhausted`              | This error will be received when a user runs out of their developer plan credits.                                                                                          |


# Getting Help

### Twitter

For general updates, new feature releases and community support, keep in touch with us via Twitter.

> Follow us on [Twitter](https://twitter.com/MistTrack_io).

### Email

Our official Email is Support\[at]MistTrack.io. Please email us.

### Discord

It is used for technical communication and abnormal feedback of OpenAPI service. [Click to join](https://discord.gg/2geemSyevJ)