> For the complete documentation index, see [llms.txt](https://beosinofficials-organization.gitbook.io/beosin-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://beosinofficials-organization.gitbook.io/beosin-api-documentation/api-endpoints/malicious-address-query-v2.md).

# Malicious Address Query V2

### Description

Check if the target is a risky entity.

### Basic Info

> * Request method: GET
> * Interface URL: <https://api.beosin.com/api/v2/kyt/tag/malicious>
> * Content-Type: application/json
> * Verification method: SIGN
> * Response Time：<30s

### **Header** Request Parameter

<table><thead><tr><th width="150">Parameter</th><th width="193">Required Field (Y/N)</th><th width="157">Parameter Type</th><th width="250">Description</th></tr></thead><tbody><tr><td><a href="/beosin-api-documentation/getting-started/verification.md">APPID</a></td><td>Y</td><td>String</td><td>Unique authentication APPID assigned by KYT system</td></tr><tr><td><a href="/beosin-api-documentation/getting-started/verification.md">APP-SECRET</a></td><td>Y</td><td>String</td><td>Unique authentication APP-SECRET assigned by KYT system</td></tr></tbody></table>

### Query Parameter

<table><thead><tr><th width="150">Parameter</th><th width="124">Required Field (Y/N)</th><th width="164">Data Type</th><th>Description</th></tr></thead><tbody><tr><td><a href="/beosin-api-documentation/support/supported-chains.md">chainId</a></td><td>Y</td><td>String</td><td>Chain ID</td></tr><tr><td>address</td><td>Y</td><td>String</td><td>Address Hash</td></tr></tbody></table>

### Return Parameter

<table><thead><tr><th width="310">Parameter</th><th width="134">Data Type</th><th width="270">Description</th></tr></thead><tbody><tr><td>id</td><td>Number</td><td>Return id</td></tr><tr><td>code</td><td>Number</td><td>Status code</td></tr><tr><td>msg</td><td>String</td><td>Result Message</td></tr><tr><td>data</td><td>Object</td><td>Result set</td></tr><tr><td>data.address</td><td>String</td><td>Address Hash</td></tr><tr><td>data.isMalicious</td><td>Boolean</td><td>Whether it is a malicious address</td></tr><tr><td>data.maliceDetail</td><td>Object</td><td>Malicious Address Details</td></tr><tr><td>data.maliceDetail.source</td><td>String</td><td>Source of the Malicious Address</td></tr><tr><td>data.maliceDetail.maliceTags</td><td>Array</td><td>Label Information</td></tr><tr><td>data.maliceDetail.maliceTags[0].tagType</td><td>Array</td><td>Label Type</td></tr><tr><td>data.maliceDetail.maliceTags[0].tag</td><td>String</td><td>Label</td></tr><tr><td>data.isSanction</td><td>Boolean</td><td>Whether It is in the Sancation List</td></tr><tr><td>data.sanctionDetail</td><td>Object</td><td>Sanction Address Details</td></tr><tr><td>data.sanctionDetail.standard</td><td>String</td><td>Outgoing address for this transaction</td></tr><tr><td>data.sanctionDetail.tag</td><td>Array</td><td>Tag set for this address</td></tr><tr><td>data.sanctionDetail.entity</td><td>String</td><td>Sanction Entity</td></tr><tr><td>data.sanctionDetail.country</td><td>String</td><td>Sanction Country</td></tr><tr><td>data.sanctionDetail.source</td><td>String</td><td>Sanction Source</td></tr><tr><td>data.isInCustomerBlackList</td><td>Boolean</td><td>Whether the Address is in the Customer Blacklist</td></tr></tbody></table>

### Example of Request Data

```
GET https://api.beosin.com/api/v2/kyt/tag/malicious?chainId=1&address=0x901bb9583b24d97e995513c6778dc6888ab6870e
```

### Example of Return Data

```json
{
  "id": 2071864046755426304,
  "code": 200,
  "msg": "success",
  "data": {
    "address": "0x901bb9583b24d97e995513c6778dc6888ab6870e",
    "isMalicious": true,
    "maliceDetail": {
      "source": "",
      "maliceTags": [
        {
          "tagType": "Associated Address Of Sanction",
          "tag": "Ofac"
        }
      ]
    },
    "isSanction": true,
    "sanctionDetail": {
      "standard": "OFAC",
      "tag": "Lifshits Artem Mikhaylovich",
      "entity": "Lifshits Artem Mikhaylovich",
      "country": "Russia",
      "source": "https://ofac.treasury.gov/recent-actions/20211108"
    },
    "isInCustomerBlackList": false
  }
}
```