Beosin API Documentation
  • ⭐Getting Started
    • Get API Access key
    • Verification
    • Setting the risk strategy
    • Setting the risk score
  • 🎯API Endpoints
    • Basic
      • Account balance query
    • Compliance
      • Deposit Transaction Assessment
        • Change Logs
      • Withdrawal Transaction Assessment
        • Change Logs
      • EOA Address Risk Assessment
        • Change Logs
      • EOA Address Risk Assessment (Deprecated)
        • Change Logs
      • Token Risk Assessment (Deprecated)
      • Malicious Address Query
        • Change Logs
      • VASP Query
        • Change Logs
      • Entity Query (Deprecated)
        • Change Logs
    • Security
      • 1. Black address screening
  • 🤝Support
    • Common Result Messages
    • Rate Limits
    • Some Common Labels and Types
    • Supported Blockchain Platforms
    • Common Sanction Guidelines and Sanctioned Entities
    • Contact Us
Powered by GitBook
On this page
  • Description
  • Tips
  • Basic Info
  • Header Request Parameter
  • Query Parameter
  • Return Parameter
  • Example of Request Data
  • Example of Response Data
  • Error Code
  1. API Endpoints
  2. Compliance

EOA Address Risk Assessment (Deprecated)

Description

We comprehensively assess the legitimacy of all fund sources in the address's historical data, the security of outgoing transactions, and whether they involve criminal activities, sanctions, etc. Based on the proportion of funds and risk strategies, we determine the probability of risk and the corresponding risk level for this transaction.

Tips

  1. The scores generated by the system evaluation are conclusions derived from a subjective logical model based on specific environments and policies. These scores cannot be directly associated with objective actual risks.

  2. Different jurisdictions and compliance strategies can significantly impact the risk assessment model. If you need a customized scoring strategy, please log in to the KYTWEB product to adjust risk control strategies according to your actual business needs.

Basic Info

  • Request method: GET

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

  • Content-Type: application/json

  • Verification method: SIGN

Header Request Parameter

Parameter
Required Field (Y/N)
Parameter Type
Description

Y

String

Unique authentication APPID assigned by KYT system

Y

String

Unique authentication APP-SECRET assigned by KYT system

Query Parameter

Parameter
Required Field (Y/N)
Parameter Type
Description

Y

String

Chain ID

address

Y

String

Address Hash

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

data.incomingScore

Double

Deposit Risk Scoring

data.incomingLevel

String

Address Deposit Risk Level

data.incomingDetail

Array

Address Deposit Hit the Risk

data.incomingDetail[0].strategyName

String

Deposit Risk-hitting Strategy

data.incomingDetail[0].riskDetails

Array

Address Deposit Risk Details

data.incomingDetail[0].riskDetails[0].riskName

String

Risk Name

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

data.outgoingDetail

Array

Address Withdrawal Hit the Risk

data.outgoingDetail[0].strategyName

String

Withdrawal Risk-hitting Strategy

data.outgoingDetail[0].riskDetails

Array

Address Withdrawal Risk Details

data.outgoingDetail[0].riskDetails[0].riskName

String

Risk Name

data.outgoingDetail[0].riskDetails[0].rate

Double

Proportion of Funds (4 Valid Digits Reserved)

data.outgoingDetail[0].riskDetails[0].amount

BigDecimal

Amount

Example of Request Data

https://api.beosin.com/api/v2/kyt/address/risk?chainId=1&address=0x4fe666ecc5263f5dbb34adb8bc1c8cbb9bbcd1cc

Example of Response Data

{
  "code": 200,
  "msg": "success",
  "data": {
    "score": 0,
    "riskLevel": "Severe",
    "incomingScore": 0,
    "incomingLevel": "Severe",
    "incomingDetail": [
      {
        "strategyName": "Systematic generic risk strategy",
        "riskDetails": [
          {
            "riskName": "Hacker",
            "rate": 1,
            "amount": 1009604.223218
          }
        ]
      }
    ],
    "outgoingScore": 0,
    "outgoingLevel": "Severe",
    "outgoingDetail": [
      {
        "strategyName": "Systematic generic risk strategy",
        "riskDetails": [
          {
            "riskName": "Hacker",
            "rate": 1,
            "amount": 1009592.258624
          }
        ]
      }
    ]
  }
}

Error Code

Error Code
Description

40021

Platform not supported

40001

Parameter error

41026

Assessment for ERC-20 contract addresses are not supported.

PreviousChange LogsNextChange Logs

Last updated 4 months ago

🎯
APPID
APP-SECRET
chainId