> 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-withdrawal-transaction-assessment.md).

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

<table><thead><tr><th width="150">Parameter</th><th width="193">Required Field (Y/N)</th><th width="157">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="150">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="305">Parameter</th><th width="175">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/withdraw?chainId=1&hash=0xf65b781a0fc3cadb688d8b19a2dcc66dcb2393e635b390831e802fe240f0609b
```

### Example of Response Data

```json
{
  "id": 2071864046755426304,
  "code": 200,
  "msg": "success",
  "data": {
    "score": 86.18207999516399,
    "riskLevel": "Medium",
    "risks": [
      {
        "riskStrategy": "Darknet Market",
        "riskDetails": [
          {
            "riskName": "Darknet Market",
            "rate": 0.1932,
            "amount": 1790.83452312220864
          }
        ]
      }
    ]
  }
}
```