> 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/kya-eoa-address-risk-assessment.md).

# KYA-EOA Address Risk Assessment

### Description

Beosin-KYT will penetrate transactions for the target address based on your specified asset type and risk strategy to analyze the inflow and outflow of funds.

### Applicable Scenarios

1、  When receiving funds, you can assess the risk of the source address.

2、  When funds are transferred out, you can assess the risk of the destination address.

### Basic Info

> * Request method: GET
> * Interface URL: <https://api.beosin.co&#x6D;_/_&#x61;pi/v3/kyt/address/risk>
> * 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="150">Parameter</th><th width="124">Required Field (Y/N)</th><th width="164">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>address</td><td>Y</td><td>String</td><td>Wallet address</td></tr><tr><td>token</td><td>N</td><td>String</td><td>Token address, defaults to native token if not entered.</td></tr></tbody></table>

### Return Parameter

<table><thead><tr><th width="323">Parameter</th><th width="157">Parameter Type</th><th width="270">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>Double</td><td><p>Total score of address.</p><p>0&#x3C;=score&#x3C;=100</p></td></tr><tr><td>data.riskLevel</td><td>String</td><td>Address Risk Level (Severe,High,Medium,Low)</td></tr><tr><td>data.incomingScore</td><td>Double</td><td>Deposit Risk Scoring</td></tr><tr><td>data.incomingLevel</td><td>String</td><td>Address Deposit Risk Level(Severe,High,Medium,Low)</td></tr><tr><td>data.incomingDetail</td><td>Array</td><td>Address Deposit Hit the Risk</td></tr><tr><td>data.incomingDetail[0].strategyName</td><td>String</td><td>Deposit 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.incomingDetail[0].riskDetails</td><td>Array</td><td>Address Deposit Risk Details</td></tr><tr><td>data.incomingDetail[0].riskDetails[0].riskName</td><td>String</td><td>Risk Name: <a href="/beosin-api-documentation/support/risk-type-list.md">Risk Type List</a></td></tr><tr><td>data.incomingDetail[0].riskDetails[0].rate</td><td>Double</td><td>Proportion of Funds (4 Valid Digits Reserved)</td></tr><tr><td>data.incomingDetail[0].riskDetails[0].amount</td><td>BigDecimal</td><td>Amount</td></tr><tr><td>data.outgoingScore</td><td>Double</td><td>Withdrawal Risk Scoring</td></tr><tr><td>data.outgoingLevel</td><td>String</td><td>Address Withdrawal Risk Level(Severe,High,Medium,Low)</td></tr><tr><td>data.outgoingDetail</td><td>Array</td><td>Address Withdrawal Hit the Risk</td></tr><tr><td>data.outgoingDetail[0].strategyName</td><td>String</td><td>Withdrawal 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.outgoingDetail[0].riskDetails</td><td>Array</td><td>Address Withdrawal Risk Details</td></tr><tr><td>data.outgoingDetail[0].riskDetails[0].riskName</td><td>String</td><td>Risk Name: <a href="/beosin-api-documentation/support/risk-type-list.md">Risk Type List</a></td></tr><tr><td>data.outgoingDetail[0].riskDetails[0].rate</td><td>Double</td><td>Proportion of Funds (4 Valid Digits Reserved)</td></tr><tr><td>data.outgoingDetail[0].riskDetails[0].amount</td><td>BigDecimal</td><td>Amount</td></tr><tr><td>data.riskTagScore</td><td>Double</td><td>The risk score of the risk label for the address you queried (based on the set risk level).</td></tr><tr><td>data.riskTagLevel</td><td>String</td><td>The risk level of the risk label for the address you queried (based on your settings).(Severe,High,Medium,Low)</td></tr><tr><td>data.riskTagDetails</td><td>Array</td><td>The risk label type for the address you queried.</td></tr></tbody></table>

### Example of Request Data

```
https://api.beosin.com/api/v3/kyt/address/risk?chainId=1&address=0x013b646fe54562a3ff6e3469fcc8c4efc2337656&token=0xdac17f958d2ee523a2206206994597c13d831ec7
```

### Example of Response Data

````json
```json
{
    "id": 2071864046755426304,
    "code": 200,
    "msg": "success",
    "data": {
        "score": 80.0,
        "riskLevel": "High",
        "incomingScore": 80.0,
        "incomingLevel": "High",
        "incomingDetail": [
            {
                "strategyName": "Sanctions",
                "riskDetails": [
                    {
                        "riskName": "Sanctions",
                        "rate": 0,
                        "amount": 3.871346676169393E-4
                    }
                ]
            }
        ],
        "outgoingScore": 80.0,
        "outgoingLevel": "High",
        "outgoingDetail": [
            {
                "strategyName": "Sanctions",
                "riskDetails": [
                    {
                        "riskName": "Sanctions",
                        "rate": 0,
                        "amount": 1.3418844427873802E-4
                    }
                ]
            },
            {
                "strategyName": "Hacker",
                "riskDetails": [
                    {
                        "riskName": "Hacker",
                        "rate": 0.01236,
                        "amount": 336263.8981953118
                    }
                ]
            }
        ],
        "riskTagScore": 80.0,
        "riskTagLevel": "High",
        "riskTagDetails": [
            "Hacker"
        ]
    }
}
```
````