Withdrawal Transaction Assessment

Applicable Scenarios

When there is an outgoing transaction, you need to conduct a risk assessment of the destination of the funds.

Description

Beosin-KYT will calculate the specified asset in the transaction according to your configured risk strategy and conduct in-depth tracing to assess the risk of the counterparties involved in the asset's destination.

Basic Info

• Request method: GET

• Interface URL: https://api.beosin.com/api/v2/kyt/tx/withdraw

• 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
hash	Y	String	Transaction Hash
token	N	String	If it is a non-native token transaction(eg. USDT, Pepe, UNI, etc.), pls also add the token address in your request. While if it a native token transaciton (eg. ETH, BTC, Sol, etc.), you are supposed to add the token name in your request.

Return Parameter

Parameter	Parameter Type	Description
code	Integer	Status code
msg	String	Result Message
data	Object	Result set
data.score	Bigdecimal	Address Scoring
data.riskLevel	String	Address Risk Level
data.risks	Array	Address Hit the Risk
data.risks[0].riskStrategy	String	Risk Hitting Strategy
data.risks[0].riskDetails	Array	Details of the Risk
data.risks[0].riskDetails[0].riskName	String	Risk Name
data.risks[0].riskDetails[0].rate	Bigdecimal	Proportion of Funds (4 Valid Digits Reserved)
data.risks[0].riskDetails[0].amount	Bigdecimal	Amount

Example of Request Data

https://api.beosin.com/api/v2/kyt/tx/withdraw?chainId=1&hash=0xf65b781a0fc3cadb688d8b19a2dcc66dcb2393e635b390831e802fe240f0609b

Example of Response Data

{
  "code": 200,
  "msg": "success",
  "data": {
    "score": 86.18207999516399,
    "riskLevel": "Medium",
    "risks": [
      {
        "riskStrategy": "Systematic generic risk strategy",
        "riskDetails": [
          {
            "riskName": "Black List",
            "rate": 0.1932,
            "amount": 1790.83452312220864
          },
          {
            "riskName": "Exchange",
            "rate": 0.1343,
            "amount": 1245.2785253990016
          }
        ]
      }
    ]
  }
}

Error Code

Error Code	Description
41024	Assessments for non-ERC20 transactions are not supported.
40023	Transaction Hash error
40021	Platform not supported
40001	Parameter error
41023	Transaction Hash not exist.
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.