# Get KYT Results

{% hint style="info" %}
Before making any API requests, please refer to the [#getting-started](https://docs.zk.me/hub/start/onboarding/integration/api/..#getting-started "mention") section on the [](https://docs.zk.me/hub/start/onboarding/integration/api "mention") page to obtain the necessary API access parameters.
{% endhint %}

## Get API Status

{% tabs %}
{% tab title="URL" %}

```ruby
POST https://agw.zk.me/zkseradmin/openapi/kyt/status
```

{% endtab %}

{% tab title="Request" %}

#### Request Body <a href="#parameters" id="parameters"></a>

```json
  {
    "apiKey": "YourApiKey",
    "mchNo": "YourMchNo"
  }
```

#### Fields Explanation <a href="#parameters" id="parameters"></a>

<table><thead><tr><th width="116">Name</th><th width="83.732421875">Type</th><th>Description</th></tr></thead><tbody><tr><td>apiKey</td><td>string</td><td>Your API key</td></tr><tr><td>mchNo</td><td>string</td><td>Same as AppID in the <a href="https://dashboard.zk.me/integration">Dashboard</a></td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

#### Sample Response <a href="#sample-response" id="sample-response"></a>

```json
{
  "code": 200,
  "message": "success",
  "data": {
    "support_api": [
      "status",
      "address_labels",
      "address_overview",
      "risk_score",
      "transactions_investigation",
    ],
    "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", 
      "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",
      "BUSD-BEP20", 
      "USDT-BEP20", 
      "WBNB-BEP20", 
      "ETH-BEP20", 
      "BTCB-BEP20",
      "DOGE-BEP20", 
      "USDC-BEP20", 
      "SHIB-BEP20", 
      "UST-BEP20",
      "MATIC-Polygon", 
      "WMATIC-Polygon", 
      "WETH-Polygon", 
      "USDC-Polygon", 
      "USDT-Polygon", 
      "DAI-Polygon",
      "WBTC-Polygon",
      "AAVE-Polygon", 
      "LINK-Polygon", 
      "UNI-Polygon", 
      "UST-Polygon", 
      "SUSHI-Polygon",
      "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-Arbitrum",
      "USDC.e-Arbitrum",
      "WETH-Arbitrum",
      "DAI-Arbitrum",
      "WBTC-Arbitrum",
      "LINK-Arbitrum",
      "GMX-Arbitrum",
      "sbfGMX-Arbitrum",
      "STG-Arbitrum",
      "MAGIC-Arbitrum",
      "BTC",
      "Cake-BEP20",
      "DAI-BEP20",
      "APE-ERC20",
      "ETH-Optimism",
      "USDT-Optimism",
      "USDC-Optimism",
      "OP-Optimism",
      "DAI-Optimism",
      "WBTC-Optimism",
      "WETH-Optimism",
      "SNX-Optimism",
      "sUSD-Optimism",
      "VELO-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"
      "ZK-zkSync",
      "WLD-Optimism",
      "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"
    ]
  }
}
```

{% endtab %}
{% endtabs %}

## Get Address Labels <a href="#get-address-labels" id="get-address-labels"></a>

Returns a list of labels for a given address.

{% tabs %}
{% tab title="URL" %}

```ruby
POST https://agw.zk.me/zkseradmin/openapi/kyt/address/labels
```

{% endtab %}

{% tab title="Request" %}

#### Request Body <a href="#parameters" id="parameters"></a>

```json
  {
    "apiKey": "YourApiKey",
    "mchNo": "YourMchNo",
    "coin": "ETH",
    "address": "{address}"
  }
```

#### Fields Explanation <a href="#parameters" id="parameters"></a>

<table><thead><tr><th width="116">Name</th><th width="83.732421875">Type</th><th>Description</th></tr></thead><tbody><tr><td>apiKey</td><td>string</td><td>Your API key</td></tr><tr><td>mchNo</td><td>string</td><td>Same as AppID in the <a href="https://dashboard.zk.me/integration">Dashboard</a></td></tr><tr><td>coin</td><td>string</td><td>The coin to check for address labels, all optional values can be found <a href="../../../../what/kyt/support-scope">here</a></td></tr><tr><td>address</td><td>string</td><td>The address to check for address labels</td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

#### Sample response <a href="#sample-response" id="sample-response"></a>

```json
{
  "code": 200,
  "message": "success",
  "data": {
    "label_list": ["Binance", "hot"],
    "label_type": "exchange"
  }
}
```

{% endtab %}
{% endtabs %}

## Get Address Actions <a href="#get-address-actions" id="get-address-actions"></a>

Returns the transaction action analysis results for a given address.

{% tabs %}
{% tab title="URL" %}

```ruby
POST https://agw.zk.me/zkseradmin/openapi/kyt/v1/address/actions
```

{% endtab %}

{% tab title="Request" %}

#### Request Body <a href="#parameters" id="parameters"></a>

```json
  {
    "apiKey": "YourApiKey",
    "mchNo": "YourMchNo",
    "coin": "ETH",
    "address": "{address}"
  }
```

#### Fields Explanation <a href="#parameters" id="parameters"></a>

<table><thead><tr><th width="128">Name</th><th width="120">Type</th><th width="363">Description</th></tr></thead><tbody><tr><td>apiKey</td><td>string</td><td>Your API key</td></tr><tr><td>mchNo</td><td>string</td><td>Same as AppID in the <a href="https://dashboard.zk.me/integration">Dashboard</a></td></tr><tr><td>coin</td><td>string</td><td>The coin to check for address overview, all optional values can be found <a href="../../../../what/kyt/support-scope">here</a></td></tr><tr><td>address</td><td>string</td><td>The address to check for overview datas</td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

#### Sample response <a href="#sample-response" id="sample-response"></a>

```json
{
  "code": 200,
  "message": "success",
  "data": {
    "received_txs": [
      {
        "action": "DEX",
        "count": 7,
        "proportion": 70
      },
      {
        "action": "Mixer",
        "count": 1,
        "proportion": 10
      },
      {
        "action": "Exchange",
        "count": 1,
        "proportion": 10
      },
      {
        "action": "Swap",
        "count": 1,
        "proportion": 10
      }
    ],
    "spent_txs": [
      {
        "action": "Exchange",
        "count": 15,
        "proportion": 57.69
      },
      {
        "action": "DEX",
        "count": 2,
        "proportion": 7.69
      },
      {
        "action": "Transfer",
        "count": 9,
        "proportion": 34.62
      }
    ]
  }
}
```

#### Fields <a href="#fields" id="fields"></a>

<table><thead><tr><th width="145">Name</th><th width="90">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="https://1714869198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QFkeleLOltSYnf8uj0t%2Fuploads%2FxKXZfC8Zn3nwBdRTT4N6%2FGroup%2048097329.png?alt=media&#x26;token=c58b8f58-24cc-443f-9400-6bf06f9c76d5" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## Get Address Counterparty  <a href="#get-address-counterparty" id="get-address-counterparty"></a>

Returns the counterparty analysis results for a given address.&#x20;

{% tabs %}
{% tab title="URL" %}

```ruby
POST https://agw.zk.me/zkseradmin/openapi/kyt/address/counterparty
```

{% endtab %}

{% tab title="Request" %}

#### Request Body <a href="#parameters" id="parameters"></a>

```json
  {
    "apiKey": "YourApiKey",
    "mchNo": "YourMchNo",
    "coin": "ETH",
    "address": "{address}"
  }
```

#### Fields Explanation <a href="#parameters" id="parameters"></a>

<table><thead><tr><th width="128">Name</th><th width="120">Type</th><th width="363">Description</th></tr></thead><tbody><tr><td>apiKey</td><td>string</td><td>Your API key</td></tr><tr><td>mchNo</td><td>string</td><td>Same as AppID in the <a href="https://dashboard.zk.me/integration">Dashboard</a></td></tr><tr><td>coin</td><td>string</td><td>The coin to check for address overview, all optional values can be found <a href="../../../../what/kyt/support-scope">here</a></td></tr><tr><td>address</td><td>string</td><td>The address to check for overview datas</td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

#### Sample Response <a href="#sample-response" id="sample-response"></a>

{% code fullWidth="false" %}

```json
{
  "code": 200,
  "message": "success",
  "data": [
    {
      "amount": 4150484.508,
      "name": "Uniswap",
      "percent": 49.7
    },
    {
      "amount": 2168062.159,
      "name": "Multichain",
      "percent": 25.961
    },
    {
      "amount": 2024879.354,
      "name": "Tornado.Cash",
      "percent": 24.247
    },
    {
      "amount": 4541.034,
      "name": "Unknown",
      "percent": 0.054
    },
    {
      "amount": 1923.578,
      "name": "SushiSwap",
      "percent": 0.023
    },
    {
      "amount": 972.055,
      "name": "sideshift.ai",
      "percent": 0.012
    },
    {
      "amount": 244.696,
      "name": "Binance",
      "percent": 0.003
    }
  ]
}
```

{% endcode %}

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

<figure><img src="https://1714869198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QFkeleLOltSYnf8uj0t%2Fuploads%2FaAcFkS3EYMMYWEHiXLrF%2Fimage.png?alt=media&#x26;token=01798db7-ce65-415f-b653-0d628ef7e803" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## Get Address Overview <a href="#get-address-overview" id="get-address-overview"></a>

Returns the balance and statistics for a given address.&#x20;

{% tabs %}
{% tab title="URL" %}

```ruby
POST https://agw.zk.me/zkseradmin/openapi/kyt/address/overview
```

{% endtab %}

{% tab title="Request" %}

#### Request Body <a href="#parameters" id="parameters"></a>

```json
  {
    "apiKey": "YourApiKey",
    "mchNo": "YourMchNo",
    "coin": "ETH",
    "address": "{address}"
  }
```

#### Fields Explanation <a href="#parameters" id="parameters"></a>

<table><thead><tr><th width="111">Name</th><th width="86">Type</th><th>Description</th></tr></thead><tbody><tr><td>apiKey</td><td>string</td><td>Your API key</td></tr><tr><td>mchNo</td><td>string</td><td>Same as AppID in the <a href="https://dashboard.zk.me/integration">Dashboard</a></td></tr><tr><td>coin</td><td>string</td><td>The coin to check for address overview, all optional values can be found <a href="../../../../what/kyt/support-scope">here</a></td></tr><tr><td>address</td><td>string</td><td>The address to check for overview datas</td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

#### Sample response <a href="#sample-response" id="sample-response"></a>

```json
{
  "code": 200,
  "message": "success",
  "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
  }
}
```

#### Fields <a href="#fields" id="fields"></a>

<table><thead><tr><th width="190">Name</th><th width="92">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>
{% endtab %}
{% endtabs %}

## Get Address Profile <a href="#get-address-profile" id="get-address-profile"></a>

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.

{% tabs %}
{% tab title="URL" %}

```ruby
POST https://agw.zk.me/zkseradmin/openapi/kyt/v1/address/profile
```

{% endtab %}

{% tab title="Request" %}

#### Request Body <a href="#parameters" id="parameters"></a>

```json
  {
    "apiKey": "YourApiKey",
    "mchNo": "YourMchNo",
    "coin": "ETH",
    "address": "{address}"
  }
```

#### Fields Explanation <a href="#parameters" id="parameters"></a>

<table><thead><tr><th width="128">Name</th><th width="120">Type</th><th width="363">Description</th></tr></thead><tbody><tr><td>apiKey</td><td>string</td><td>Your API key</td></tr><tr><td>mchNo</td><td>string</td><td>Same as AppID in the <a href="https://dashboard.zk.me/integration">Dashboard</a></td></tr><tr><td>coin</td><td>string</td><td>The coin to check for address overview, all optional values can be found <a href="../../../../what/kyt/support-scope">here</a></td></tr><tr><td>address</td><td>string</td><td>The address to check for overview datas</td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

#### Sample response <a href="#sample-response" id="sample-response"></a>

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

#### Fields <a href="#fields" id="fields"></a>

<table><thead><tr><th width="190">Name</th><th width="92">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 three 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>
{% endtab %}
{% endtabs %}

## Get Risk Score <a href="#get-risk-score" id="get-risk-score"></a>

Returns the risk score, risk detail list for a given address or transaction hash.

{% tabs %}
{% tab title="URL" %}

```ruby
POST https://agw.zk.me/zkseradmin/openapi/kyt/risk/score
```

{% endtab %}

{% tab title="Request" %}

#### Request Body <a href="#parameters" id="parameters"></a>

```json
  {
    "apiKey": "YourApiKey",
    "mchNo": "YourMchNo",
    "coin": "ETH",
    "address": "{address}",
    "txid": "{txn hash (optional)}"
  }
```

#### Fields Explanation <a href="#parameters" id="parameters"></a>

<table><thead><tr><th width="112">Name</th><th width="82">Type</th><th>Description</th></tr></thead><tbody><tr><td>apiKey</td><td>string</td><td>Your API key</td></tr><tr><td>mchNo</td><td>string</td><td>Same as AppID in the <a href="https://dashboard.zk.me/integration">Dashboard</a></td></tr><tr><td>coin</td><td>string</td><td>The coin to check for risk score, all optional values can be found <a href="../../../../what/kyt/support-scope">here</a></td></tr><tr><td>address</td><td>string</td><td>The address to check for risk score, one of address and txid must be passed.</td></tr><tr><td>txid</td><td>string</td><td>The address to check for risk score, one of address and txid must be passed. If you are unsure of its value, please ignore it directly and do not pass any non-existent or fictional values.</td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

#### Sample response  <a href="#sample-response" id="sample-response"></a>

```json
{
  "code": 200,
  "message": "success",
  "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
      }
    ]
  }
}
```

#### Fields <a href="#fields" id="fields"></a>

<table><thead><tr><th width="160">Name</th><th width="93">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>string[]</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>object[]</td><td>Data for the risk score calculation process</td></tr></tbody></table>

#### Risk Descriptions for `detail_list` <a href="#risk-descriptions-for-detail_list" id="risk-descriptions-for-detail_list"></a>

<table><thead><tr><th width="223">Risk Item</th><th>Risk Item</th></tr></thead><tbody><tr><td>Malicious Address</td><td>Address directly involved in malicious events, Example: DeFi protocol exploiters, centralized exchange hackers, sanctioned addresses, etc.</td></tr><tr><td>Suspected Malicious Address</td><td>Address associated with malicious events</td></tr><tr><td>High-risk Tag Address</td><td>High-risk entity address, Example: Mixers, some nested exchanges, etc.</td></tr><tr><td>Medium-risk Tag Address</td><td>High-risk entity address, Example: Mixers, some nested exchanges, etc.</td></tr><tr><td>Mixer</td><td>Mixer entity address, Example: Tornado Cash, etc.</td></tr><tr><td>Risk Exchange</td><td>Exchanges that do not require KYC</td></tr><tr><td>Gambling</td><td>Gambling entity address</td></tr><tr><td>Involved Theft Activity</td><td>Address involved in theft events</td></tr><tr><td>Involved Ransom Activity</td><td>Address involved in ransom events</td></tr><tr><td>Involved Phishing Activity</td><td>Address involved in phishing events</td></tr><tr><td>Interact With Malicious Address</td><td>Interactions with malicious address</td></tr><tr><td>Interact With Suspected Malicious Address</td><td>Interactions with suspected malicious address</td></tr><tr><td>Interact With High-risk Tag Address</td><td>Interactions with high-risk address</td></tr><tr><td>Interact With Medium-risk Tag Addresses</td><td>Interactions with medium-risk address</td></tr></tbody></table>

#### Risk Level Guide <a href="#risk-level-guide" id="risk-level-guide"></a>

<table><thead><tr><th width="126">Risk Level</th><th width="113">Risk Score</th><th>Suggested Operations</th></tr></thead><tbody><tr><td>Severe</td><td>91 ~ 100</td><td>Prohit 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 zkMe 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>
{% endtab %}
{% endtabs %}

## Get Transactions Investigation <a href="#get-transactions-investigation" id="get-transactions-investigation"></a>

{% tabs %}
{% tab title="URL" %}

```ruby
POST https://agw.zk.me/zkseradmin/openapi/kyt/transactions/investigation
```

{% endtab %}

{% tab title="Request" %}

#### Request Body <a href="#parameters" id="parameters"></a>

```json
  {
    "apiKey": "YourApiKey",
    "mchNo": "YourMchNo",
    "coin": "ETH",
    "address": "{address}",
    "start_timestamp": 0,
    "end_timestamp": 1710000000,
    "type": "all",
    "page": 1
  }
```

#### Fields Explanation <a href="#parameters" id="parameters"></a>

<table><thead><tr><th width="181">Name</th><th width="78">Type</th><th>Description</th></tr></thead><tbody><tr><td>apiKey</td><td>string</td><td>Your API key</td></tr><tr><td>mchNo</td><td>string</td><td>Same as AppID in the <a href="https://dashboard.zk.me/integration">Dashboard</a></td></tr><tr><td>coin</td><td>string</td><td>The coin to check for transaction investigation, all optional values can be found <a href="../../../../what/kyt/support-scope">here</a></td></tr><tr><td>address</td><td>string</td><td>The address to check for transaction investigation</td></tr><tr><td>start_timestamp</td><td>int</td><td>The start timestamp to check for transaction investigation<br>(optional, default is 0)</td></tr><tr><td>end_timestamp</td><td>int</td><td>The end timestamp to check for transaction investigation<br>(optional, default is current timestamp)</td></tr><tr><td>type</td><td>string</td><td>The type to check for transaction investigation<br>(optional value “in”, “out” and “all”, default is “all”)</td></tr><tr><td>page</td><td>int</td><td>Page number<br>(optional, default is 1)</td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

#### Sample Response

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

#### Response Data Parameters <a href="#response-data-parameters" id="response-data-parameters"></a>

<table><thead><tr><th width="214">Name</th><th width="75">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<br>(maximum is 1000)</td></tr></tbody></table>

#### Response Data Unit Parameters  <a href="#response-data-unit-parameters" id="response-data-unit-parameters"></a>

<table><thead><tr><th width="138">Name</th><th width="91">Type</th><th>Description</th></tr></thead><tbody><tr><td>address</td><td>string</td><td>The transfer-in transaction list of the querying address</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><tr><td>tx_hash_list </td><td>list</td><td>Transfer transaction hash list</td></tr><tr><td>type</td><td>int</td><td>1: EOA address / bitcoin address;<br>2: malicious address;<br>3: entity label address;<br>4: contract address</td></tr></tbody></table>
{% endtab %}
{% endtabs %}