> For the complete documentation index, see [llms.txt](https://beosinofficials-organization.gitbook.io/beosin-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://beosinofficials-organization.gitbook.io/beosin-api-documentation/api-endpoints/compliance-v3/kyt-deposit-transaction-assessment.md).

# KYT-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 assess 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.

### Basic Info

> * Request method: GET
> * Interface URL: <https://api.beosin.com/api/v2/kyt/tx/deposit>
> * Content-Type: application/json
> * Verification method: SIGN
> * Response Time：<30s

### **Header Request Parameter**

<table><thead><tr><th width="150">Parameter</th><th width="193">Required Field (Y/N)</th><th width="151">Parameter Type</th><th width="250">Description</th></tr></thead><tbody><tr><td><a href="/beosin-api-documentation/getting-started/verification.md">APPID</a></td><td>Y</td><td>String</td><td>Unique authentication APPID assigned by KYT system</td></tr><tr><td><a href="/beosin-api-documentation/getting-started/verification.md">APP-SECRET</a></td><td>Y</td><td>String</td><td>Unique authentication APP-SECRET assigned by KYT system</td></tr></tbody></table>

### Query Parameter

<table><thead><tr><th width="151">Parameter</th><th width="147">Required Field (Y/N)</th><th width="176">Parameter Type</th><th>Description</th></tr></thead><tbody><tr><td><a href="/beosin-api-documentation/support/supported-chains.md">chainId</a></td><td>Y</td><td>String</td><td>Chain ID</td></tr><tr><td>hash</td><td>Y</td><td>String</td><td>Transaction Hash</td></tr><tr><td>token</td><td>N</td><td>String</td><td>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.</td></tr></tbody></table>

### Return Parameter

<table><thead><tr><th width="330">Parameter</th><th>Parameter Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>Number</td><td>Return id</td></tr><tr><td>code</td><td>Integer</td><td>Status code</td></tr><tr><td>msg</td><td>String</td><td>Result Message</td></tr><tr><td>data</td><td>Object</td><td>Result set</td></tr><tr><td>data.score</td><td>Bigdecimal</td><td>Address Scoring</td></tr><tr><td>data.riskLevel</td><td>String</td><td>Address Risk Level(Severe,High,Medium,Low)</td></tr><tr><td>data.risks</td><td>Array</td><td>Address Hit the Risk</td></tr><tr><td>data.risks[0].riskStrategy</td><td>String</td><td>Risk Hitting Strategy<br>Strategy Type: <a href="/beosin-api-documentation/support/risk-type-list.md">Risk Type List</a></td></tr><tr><td>data.risks[0].riskDetails</td><td>Array</td><td>Details of the Risk</td></tr><tr><td>data.risks[0].riskDetails[0].riskName</td><td>String</td><td>Risk Type: <a href="/beosin-api-documentation/support/risk-type-list.md">Risk Type List</a></td></tr><tr><td>data.risks[0].riskDetails[0].rate</td><td>Bigdecimal</td><td>Proportion of Funds (4 Valid Digits Reserved)</td></tr><tr><td>data.risks[0].riskDetails[0].amount</td><td>Bigdecimal</td><td>Amount</td></tr></tbody></table>

### Example of Request Data

```
https://api.beosin.com/api/v2/kyt/tx/deposit?
chainId=1&hash=0x919aeb1d0ed579dbbe15a0a695b221c746c2b45d68553da0c203747c1255f739
```

### Example of Response Data

```json
{
  "id": 2071864046755426304,
  "code": 200,
  "msg": "success",
  "data": {
    "score": 59.56699999999999,
    "riskLevel": "High",
    "risks": [
      {
        "riskStrategy": "Darknet Market",
        "riskDetails": [
          {
            "riskName": "Darknet Market",
            "rate": 0.5311,
            "amount": 4923.976808
          }
        ]
      }
    ]
  }
}
```