# 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="../support/getting-help">contact us</a> if the issue persists.</td></tr></tbody></table>

[Error messages](https://docs.misttrack.io/support/common-error-messages) in other situations.