Malicious Address Query

Description

Query all related security compliance labels, such as malicious addresses, administrative sanctions, and blacklists, etc.

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

Parameter	Required Field (Y/N)	Parameter Type	Description
APPID	Y	String	Unique authentication APPID assigned by KYT system
APP-SECRET	Y	String	Unique authentication APP-SECRET assigned by KYT system

Query Parameter

Parameter	Required Field (Y/N)	Parameter Type	Description
chainId	Y	String	Chain ID
address	Y	String	Address Hash

Return Parameter

Parameter	Parameter Type	Description
code	Number	Status code
msg	String	Result Message
data	Object	Result set
data.address	String	Address Hash
data.isMalicious	Boolean	Whether it is a malicious address
data.maliceDetail	Object	Malicious Address Details
data.maliceDetail.source	String	Source of the Malicious Address
data.maliceDetail.maliceTags	Array	Label Information
data.maliceDetail.maliceTags[0].tagType	Array	Label Type
data.maliceDetail.maliceTags[0].tag	String	Label
data.isSanction	Boolean	Whether It is in the Sancation List
data.sanctionDetail	Object	Sanction Address Details
data.sanctionDetail.standard	String	Outgoing address for this transaction
data.sanctionDetail.tag	Array	Tag set for this address
data.sanctionDetail.entity	String	Sanction Entity
data.sanctionDetail.country	String	Sanction Country
data.sanctionDetail.source	String	Sanction Source
data.isInCustomerBlackList	Boolean	Whether the Address is in the Customer Blacklist

Example of Request Data

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

Example of Return Data

{
  "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
  }
}

Error Code

Error Code	Description
40021	Platform not supported
40022	Address error