# 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 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 MCP](https://github.com/slowmist/MistTrackMCP).

### 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</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</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</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</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</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                                                                  |
| `v2/risk_score`                                            | Returns the risk score, risk detail list for a given address/txid                                                       |
| `v2/risk_score_create_task`  &  `v2/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>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.md) in other situations.


---

# Agent Instructions: Querying This Documentation

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

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

```
GET https://docs.misttrack.io/openapi/overview.md?ask=<question>
```

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

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