EOA Address Risk Assessment

Description

Beosin-KYT will penetrate transactions for the target address based on your specified asset type and risk strategy to analyze the inflow and outflow of funds.

Applicable Scenarios

1、 When receiving funds, you can assess the risk of the source address.

2、 When funds are transferred out, you can assess the risk of the destination address.

Basic Info

• Request method: GET

• Interface URL: https://api.beosin.com/api/v3/kyt/address/risk

• 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
token	N	String	Token address, defaults to native token if not entered.

Return Parameter

Parameter	Parameter Type	Description
code	Integer	Status code
msg	String	Result Message
data	Object	Result set
data.score	Double	Total score of address. 0<=score<=100
data.riskLevel	String	Address Risk Level (Server,High,Medium,Low)
data.incomingScore	Double	Deposit Risk Scoring
data.incomingLevel	String	Address Deposit Risk Level(Server,High,Medium,Low)
data.incomingDetail	Array	Address Deposit Hit the Risk
data.incomingDetail[0].strategyName	String	Deposit Risk-hitting Strategy Strategy Type: Risk Type List
data.incomingDetail[0].riskDetails	Array	Address Deposit Risk Details
data.incomingDetail[0].riskDetails[0].riskName	String	Risk Name: Risk Type List
data.incomingDetail[0].riskDetails[0].rate	Double	Proportion of Funds (4 Valid Digits Reserved)
data.incomingDetail[0].riskDetails[0].amount	BigDecimal	Amount
data.outgoingScore	Double	Withdrawal Risk Scoring
data.outgoingLevel	String	Address Withdrawal Risk Level(Server,High,Medium,Low)
data.outgoingDetail	Array	Address Withdrawal Hit the Risk
data.outgoingDetail[0].strategyName	String	Withdrawal Risk-hitting Strategy Strategy Type: Risk Type List
data.outgoingDetail[0].riskDetails	Array	Address Withdrawal Risk Details
data.outgoingDetail[0].riskDetails[0].riskName	String	Risk Name: Risk Type List
data.outgoingDetail[0].riskDetails[0].rate	Double	Proportion of Funds (4 Valid Digits Reserved)
data.outgoingDetail[0].riskDetails[0].amount	BigDecimal	Amount
data.riskTagScore	Double	The risk score of the risk label for the address you queried (based on the set risk level).
data.riskTagLevel	String	The risk level of the risk label for the address you queried (based on your settings).(Server,High,Medium,Low)
data.riskTagDetails	Array	The risk label type for the address you queried.

Example of Request Data

https://api.beosin.com/api/v3/kyt/address/risk?chainId=1&address=0x013b646fe54562a3ff6e3469fcc8c4efc2337656&token=0xdac17f958d2ee523a2206206994597c13d831ec7

Example of Response Data

```json
{
    "code": 200,
    "msg": "success",
    "data": {
        "score": 80.0,
        "riskLevel": "High",
        "incomingScore": 80.0,
        "incomingLevel": "High",
        "incomingDetail": [
            {
                "strategyName": "Sanctions",
                "riskDetails": [
                    {
                        "riskName": "Sanctions",
                        "rate": 0,
                        "amount": 3.871346676169393E-4
                    }
                ]
            }
        ],
        "outgoingScore": 80.0,
        "outgoingLevel": "High",
        "outgoingDetail": [
            {
                "strategyName": "Sanctions",
                "riskDetails": [
                    {
                        "riskName": "Sanctions",
                        "rate": 0,
                        "amount": 1.3418844427873802E-4
                    }
                ]
            },
            {
                "strategyName": "Hacker",
                "riskDetails": [
                    {
                        "riskName": "Hacker",
                        "rate": 0.01236,
                        "amount": 336263.8981953118
                    }
                ]
            }
        ],
        "riskTagScore": 80.0,
        "riskTagLevel": "High",
        "riskTagDetails": [
            "Hacker"
        ]
    }
}
```

Error Code

Error Code	Description
40021	Platform not supported
40001	Parameter error
41026	Assessment for ERC-20 contract addresses are not supported.
41035	This transaction involves a token that is not in the token basket, please add that token.
41038	The task is being executed. Please try again later.