V4-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.

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.

Basic Info

Request method: GET Interface URL: https://api.beosin.com/api/v4/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

code	Integer	Status code
msg	String	Result Message
data	Object	Result set
data.score	Bigdecimal	Address Scoring
data.riskLevel	String	Address Risk Level(Server,High,Medium,Low)
data.risks	Array	Address Hit the Risk
data.risks[0].riskStrategy	String	Risk Hitting Strategy Strategy Type: Risk Type List
data.risks[0].riskLevel	String	Risk Level(Server,High,Medium,Low)
data.risks[0].hops	int	The hop count of the distance between this type of risk entity and the query target
data.risks[0].rate	Bigdecimal	Proportion of Funds (4 Valid Digits Reserved)
data.risks[0].amount	Bigdecimal	Amount
data.risks[0].entityDetails	Array
data.risks[0].entityDetails[0].entityName	String	The name of the entity
data.risks[0].entityDetails[0].hops	int	The hop count of the distance between this entity and the query target
data.risks[0].entityDetails[0].rate	Bigdecimal	Proportion of Funds (4 Valid Digits Reserved)
data.risks[0].entityDetails[0].amount	Bigdecimal	Amount

Example of Request Data

https://api.beosin.com/api/v4/kyt/tx/withdraw?chainId=1&hash=0x21459b21529509435b67da38430a11ae6bb6816f9ca340bfa20ee00e155b257f&token=

Example of Response Data

{
  "code": 200,
  "msg": "success",
  "data": {
    "score": 30,
    "riskLevel": "High",
    "risks": [
      {
        "riskStrategy": "Sanctions",
        "riskLevel": "High",
        "hops": 5,
        "rate": 0,
        "amount": 1.365666735139979144159335584E-8,
        "entityDetails": [
          {
            "entityName": "Netex24",
            "hops": 5,
            "purificationAmountU": 1.36566673513997914415933558400000E-8,
            "purificationRate": 0
          }
        ]
      },
      {
        "riskStrategy": "Official Freeze",
        "riskLevel": "Low",
        "hops": 5,
        "rate": 0.000002,
        "amount": 0.00000398565784241105254931290063392,
        "entityDetails": [
          {
            "entityName": "MetaMask",
            "hops": null,
            "purificationAmountU": 0.0000039856578424110525493129006339200000,
            "purificationRate": 0.000002
          }
        ]
      },
      {
        "riskStrategy": "Grey List - FATF",
        "riskLevel": "Low",
        "hops": 4,
        "rate": 0.000004,
        "amount": 0.00000981836741319874478402153978112,
        "entityDetails": [
          {
            "entityName": "Remitano",
            "hops": 4,
            "purificationAmountU": 0.0000078282724091474364433516800000,
            "purificationRate": 0.000004
          },
          {
            "entityName": "AltCoinTrader",
            "hops": 4,
            "purificationAmountU": 0.0000019900950040513083406698597811200000,
            "purificationRate": 0.000001
          }
        ]
      }
    ]
  }
}

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.