> 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/kyt-deposit-v5.md). # KYT Deposit V5 ### Description * Assess the source of funds for the transaction. * When a user transfers funds to a wallet address specified on your platform, this API can be used to assess the risk of the funds in that transaction. ### Basic Info > * Request Method: GET > * API URL: > * Content-Type: application/json > * Authentication: SIGN > * Response Time: <30s ### **Header** Request Parameter
ParameterRequired Field (Y/N)Parameter TypeDescription
APPIDYStringUnique authentication APPID assigned by KYT system
APP-SECRETYStringUnique authentication APP-SECRET assigned by KYT system
### Query Parameter
ParameterRequired(Y/N)Data TypeDescription
chainIdYStringBlockchain ID
hashYStringTransaction hash
tokenNStringToken contract address
### Return Parameter | Parameter | Data Type | Dedscription | | -------------------------------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------- | | id | Number | Return id | | code | Integer | Status code | | msg | String | Result message | | data | Object | Result set | | data.score | BigDecimal | Total score | | data.riskLevel | String | Risk level | | data.risks | List | Risk list | | data.risks\[].riskStrategy | String | Risk strategy | | data.risks\[].riskLevel | String | Risk level | | data.risks\[].exposure | String | Exposure type | | data.risks\[].hops | Integer | Hops | | data.risks\[].rate | BigDecimal | Proportion | | data.risks\[].amount | BigDecimal | Amount | | data.risks\[].entityDetails | List | Entity details | | data.risks\[].entityDetails\[].entityName | String | Entity name | | data.risks\[].entityDetails\[].hops | Integer | Hops | | data.risks\[].entityDetails\[].purificationAmountU | BigDecimal | Purified amount | | data.risks\[].entityDetails\[].purificationRate | BigDecimal | Purification proportion | | data.points | List | Topology node details | | data.points\[].id | String | Node ID | | data.points\[].platform | String | Platform | | data.points\[].address | String | Address Hash | | data.points\[].tokens | Set\ | Token set | | data.points\[].iniPoint | Boolean | Whether it is the source node | | data.points\[].depth | Integer | Level | | data.points\[].addressTag | Object | Address tag | | data.points\[].hitStrategy | Boolean | Whether the strategy is hit | | data.points\[].direction | String | Direction | | data.points\[].isInCustomerBlackList | Boolean | Whether in the custom blacklist | | data.lines | List | Topology link details | | data.lines\[].fromId | String | Source address ID | | data.lines\[].toId | String | Target address ID | | data.lines\[].txValueU | BigDecimal | Transaction amount | | data.lines\[].totalPercent | BigDecimal | Source node proportion | | data.lines\[].currencies | List | Currency list | | data.lines\[].currencies\[].value | BigDecimal | Token quantity | | data.lines\[].currencies\[].valueU | BigDecimal | Fiat amount | | data.lines\[].currencies\[].currencyName | String | Currency name | | data.lines\[].currencies\[].currencyTokenAddress | String | Token contract address | | data.lines\[].currencies\[].platformEnum | String | Platform enum | | data.topologyTooLarge | Boolean | Whether the number of topology nodes exceeds the limit (>500) | | data.points\[].effectiveTag | Object | Address tag | | data.lines\[].thisDeptPercent | BigDecimal | Percentage of transaction amount in total amount of this point | | data.lines\[].addressExtendTypes | Set\ | Transaction types included online: INI (Source Point), COMMON (Standard Transaction), SWAP (Currency Exchange), CROSS (Cross-Chain) | ### Request Example ``` GET https://api.beosin.com/api/v5/kyt/tx/deposit?chainId=1&hash=0xd0ee377f3dad7e0157920fe0cd05adc5a23cc3ded1c2b35969b5149148b6ac92&token=0xdac17f958d2ee523a2206206994597c13d831ec7 ``` ### Response Example ```json { "id": 2071864046755426304, "code": 200, "msg": "success", "data": { "score": 63.79, "riskLevel": "Severe", "risks": [     { "riskStrategy": "Sanctions", "riskLevel": "High", "exposure": "Indirect", "hops": 5, "rate": 0.000101, "amount": 2.008479, "entityDetails": [         { "entityName": "HTX", "hops": 5, "purificationAmountU": 2.008479, "purificationRate": 0.000101         }       ]     }   ], "points": [     { "id": "eth_0x46ce0adf2dc7ecf767704d3d73a26360bbdfd442", "platform": "ETH", "address": "0x46ce0adf2dc7ecf767704d3d73a26360bbdfd442", "tokens": [ "0xdac17f958d2ee523a2206206994597c13d831ec7"       ], "iniPoint": true, "depth": 0, "addressTag": null, "effectiveTag": null, "hitStrategy": null, "direction": "BACK", "inCustomerBlackList": false     },     { "id": "eth_0x09ce8fc016933ff400885e95a1b62747281abcc7", "platform": "ETH", "address": "0x09ce8fc016933ff400885e95a1b62747281abcc7", "tokens": [ "0xdac17f958d2ee523a2206206994597c13d831ec7"       ], "iniPoint": false, "depth": 1, "addressTag": { "black": [ "Sanctions"         ], "projectService": [], "financeService": []       }, "effectiveTag": { "type": "Sanctions", "addressTagType": "MALICIOUS", "tagType": "Sanctions"       }, "hitStrategy": true, "direction": "BACK", "inCustomerBlackList": false     }   ], "lines": [     { "fromId": "eth_0x46ce0adf2dc7ecf767704d3d73a26360bbdfd442", "toId": "eth_0x09ce8fc016933ff400885e95a1b62747281abcc7", "txValueU": 499.220814, "totalPercent": null, "currencies": [         { "value": 500.0, "valueU": 499.220814, "currencyName": "USDT", "currencyTokenAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7", "platformEnum": "ETH"         }       ], "addressExtendTypes": [ "COMMON"       ]     }   ], "topologyTooLarge": false } } ```