V4- 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.
This interface has added content for returning data: 1、Added entity details under the hit risk type, such as entity name, risk amount, and proportion. 2、Added hop count display, showing the shortest hop count between the risk type or entity and the query target.
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/v4/kyt/address/risk
Content-Type: application/json
Verification method: SIGN
Response Time：<30s
Header Request Parameter
Query Parameter
address
Y
String
Address Hash
token
N
String
Token address, defaults to native token if not entered.
Return Parameter
code
Integer
Status code
msg
String
Result Message
data
Object
Result set
data.score
Double
Total score of address.
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
Object
Address Deposit Hit the Risk
data.incomingDetail[0].strategyName
String
Deposit Risk-hitting Strategy Strategy Type: Risk Type List
data.incomingDetail[0].riskLevel
String
Risk Level of Strategy Hit in Income Direction
data.incomingDetail[0].hops
Integer
Number of Hops for Income Direction to Hit This Risk Type
data.incomingDetail[0].rate
Double
Proportion of Risk Funds Amount Corresponding to This Risk Type Hit in Income Direction to Total Income
data.incomingDetail[0].amount
Bigdecimal
Amount of Risk Funds Corresponding to This Risk Type Hit in Income Direction
data.incomingDetail[0].entityDetails
Object
Entity Details Corresponding to This Risk Type Hit in Income Direction
data.incomingDetail[0].entityDetails[0].entityName
String
Entity Name Corresponding to This Risk Type Hit in Income Direction
data.incomingDetail[0].entityDetails[0].hops
Integer
Number of Hops of the Entity Corresponding to This Risk Type Hit in Income Direction
data.incomingDetail[0].entityDetails[0].purificationAmountU
Bigdecimal
Amount of Risk Funds for the Entity Corresponding to This Risk Type Hit in Income Direction
data.incomingDetail[0].entityDetails[0].purificationRate
Double
Proportion of Risk Funds for the Entity Corresponding to This Risk Type Hit in Income Direction
data.outgoingScore
Double
Withdrawal Risk Scoring
data.outgoingLevel
String
Address Withdrawal Risk Level(Server,High,Medium,Low)
data.outgoingDetail
Object
Address Withdrawal Hit the Risk
data.outgoingDetail[0].strategyName
String
Withdrawal Risk-hitting Strategy Strategy Type: Risk Type List
data.outgoingDetail[0].riskLevel
String
Risk Level of Strategy Hit in Outgoing Direction
data.outgoingDetail[0].hops
Integer
Number of Hops for Outgoing Direction to Hit This Risk Type
data.outgoingDetail[0].rate
Double
Proportion of Risk Funds Amount Corresponding to This Risk Type Hit in Outgoing Direction to Total Outgoing
data.outgoingDetail[0].amount
Bigdecimal
Amount of Risk Funds Corresponding to This Risk Type Hit in Outgoing Direction
data.outgoingDetail[0].entityDetails
Object
Entity Details Corresponding to This Risk Type Hit in Outgoing Direction
data.outgoingDetail[0].entityDetails[0].entityName
String
Entity Name Corresponding to This Risk Type Hit in Outgoing Direction
data.outgoingDetail[0].entityDetails[0].hops
Integer
Number of Hops of the Entity Corresponding to This Risk Type Hit in Outgoing Direction
data.outgoingDetail[0].entityDetails[0].purificationAmountU
Bigdecimal
Amount of Risk Funds for the Entity Corresponding to This Risk Type Hit in Outgoing Direction
data.outgoingDetail[0].entityDetails[0].purificationRate
Double
Proportion of Risk Funds for the Entity Corresponding to This Risk Type Hit in Outgoing Direction
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/v4/kyt/address/risk?address=0xc0e80a623c9593b3c3911682d2084c4e93bea4a7&chainId=1&token=0xdac17f958d2ee523A2206206994597c13d831EC7Example of Response Data
{
"code": 200,
"msg": "success",
"data": {
"score": 90,
"riskLevel": "Low",
"incomingScore": null,
"incomingLevel": null,
"incomingDetail": [],
"outgoingScore": 90,
"outgoingLevel": "Low",
"outgoingDetail": [
{
"strategyName": "Official Freeze",
"riskLevel": "Low",
"hops": 4,
"rate": 0.000062,
"amount": 0.00392723338777528420843893,
"entityDetails": [
{
"entityName": "unnamed entity",
"hops": 4,
"purificationAmountU": 0.0039272333877752842084389300,
"purificationRate": 0.000062
}
]
},
{
"strategyName": "Phishing",
"riskLevel": "Low",
"hops": 5,
"rate": 0.000001,
"amount": 0.00006646953635297649260514144,
"entityDetails": [
{
"entityName": "unnamed entity",
"hops": 5,
"purificationAmountU": 0.0000664695363529764926051414400000,
"purificationRate": 0.000001
}
]
},
{
"strategyName": "Hacker",
"riskLevel": "Low",
"hops": 5,
"rate": 0,
"amount": 0.0000015097484150468498875033647,
"entityDetails": [
{
"entityName": "unnamed entity",
"hops": 5,
"purificationAmountU": 0.0000015097484150468498875033647000,
"purificationRate": 0
}
]
}
],
"riskTagScore": 100,
"riskTagLevel": "Low",
"riskTagDetails": []
}
}Error Code
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.
Last updated