V4-Deposit Transaction Assessment

Applicable Scenarios

When a user transfers funds to a designated wallet address on your platform, this endpoint allows you to perform a risk assessment on the source of the funds. By using this API, you can evaluate the transaction's risk level and ensure compliance with your risk management policies.

Description

Beosin-KYT will traverse all addresses in the funding source direction of the token type used by the deposit transaction, without limiting the hops and scope. If any risky entities are found during the traversal that match the risk strategies set by you, the corresponding risks will be revealed.

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/deposit 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/deposit/tx/evaluation?chainId=1&hash=0x21459b21529509435b67da38430a11ae6bb6816f9ca340bfa20ee00e155b257f&token=

Example of Response Data

{
  "code": 200,
  "msg": "success",
  "data": {
    "score": 60,
    "riskLevel": "Medium",
    "risks": [
      {
        "riskStrategy": "Official Freeze",
        "riskLevel": "Low",
        "hops": 4,
        "rate": 0.02277,
        "amount": 0.04997246930985870420248,
        "entityDetails": [
          {
            "entityName": "Tornado Cash",
            "hops": 4,
            "purificationAmountU": 0.0499724693098587042024800000000000000000,
            "purificationRate": 0.022768
          }
        ]
      },
      {
        "riskStrategy": "Gambling",
        "riskLevel": "Low",
        "hops": 4,
        "rate": 0.00059,
        "amount": 0.001294505608882045216190351504,
        "entityDetails": [
          {
            "entityName": "Stake",
            "hops": 4,
            "purificationAmountU": 0.0012115155172735960261513416320000000000,
            "purificationRate": 0.000552
          },
          {
            "entityName": "Rollbit",
            "hops": 5,
            "purificationAmountU": 0.0000046099721994443698235387040000000000,
            "purificationRate": 0.000002
          },
          {
            "entityName": "Shuffle",
            "hops": 5,
            "purificationAmountU": 0.0000783533872578921605558398080000000000,
            "purificationRate": 0.000036
          },
          {
            "entityName": "Duelbits",
            "hops": 5,
            "purificationAmountU": 2.67321511126596596313600000000000E-8,
            "purificationRate": 0
          }
        ]
      },
      {
        "riskStrategy": "Money Mule",
        "riskLevel": "Medium",
        "hops": 5,
        "rate": 0.000002,
        "amount": 0.000004375962410848045523570592,
        "entityDetails": [
          {
            "entityName": "unnamed entity",
            "hops": 5,
            "purificationAmountU": 0.0000043759624108480455235705920000000000,
            "purificationRate": 0.000002
          }
        ]
      }
    ]
  }
}

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.