> 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/address-info-v5.md).

# Address Info V5

### Description

This query provides statistical information about an address, including statistics of incoming and outgoing funds and the address's balance. Such as: number of transactions, transaction amount, first transaction time, and last transaction time.

### Basic Info

> * Request Method: GET
> * API URL: <https://api.beosin.com/api/v5/kyt/address/info>
> * Content-Type: application/json
> * Authentication: 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>Address Hash</td></tr><tr><td>token</td><td>N</td><td>String</td><td>Token contract address, defaults to native token if not entered.</td></tr></tbody></table>

### Return Parameter

| Parameter                            | Data Type  | Description                                  |
| ------------------------------------ | ---------- | -------------------------------------------- |
| id                                   | Number     | Return id                                    |
| code                                 | Integer    | Status code                                  |
| msg                                  | String     | Response message                             |
| data                                 | Object     | Response data set                            |
| data.unit                            | String     | Currency name                                |
| data.sendTxCount                     | Long       | Total number of outgoing transactions        |
| data.send                            | BigDecimal | Total outgoing token amount                  |
| data.sendU                           | BigDecimal | Total outgoing amount in USD                 |
| data.sendFirstTxTime                 | Long       | Timestamp of the first outgoing transaction  |
| data.sendLatestTxTime                | Long       | Timestamp of the latest outgoing transaction |
| data.receiveTxCount                  | Long       | Total number of incoming transactions        |
| data.receive                         | BigDecimal | Total incoming token amount                  |
| data.receiveU                        | BigDecimal | Total incoming amount in USD                 |
| data.receiveFirstTxTime              | Long       | Timestamp of the first incoming transaction  |
| data.receiveLatestTxTime             | Long       | Timestamp of the latest incoming transaction |
| data.balance                         | Object     | Balance information                          |
| data.balance.total                   | BigDecimal | Total balance                                |
| data.balance.details                 | List       | Balance details list                         |
| data.balance.details\[].tokenName    | String     | Token name                                   |
| data.balance.details\[].tokenAddress | String     | Token contract address                       |
| data.balance.details\[].balance      | BigDecimal | Token balance                                |
| data.balance.details\[].amount       | BigDecimal | Balance value in fiat currency               |

### Request Example

```
GET /v5/kyt/address/statistics?chainId=1&address=0xc0e80a623c9593b3c3911682d2084c4e93bea4a7&token=0xdac17f958d2ee523A2206206994597c13d831EC7
```

### Response Example

```json
{
    "id": 2071864046755426304,
    "code": 200,
    "msg": "success",
    "data": {
        "unit": "ETH",
        "sendTxCount": 1,
        "send": 1233.981173423,
        "sendU": 2483372.7066368395,
        "sendFirstTxTime": 1648748946,
        "sendLatestTxTime": 1648748946,
        "receiveTxCount": 22,
        "receive": 1233.982223423943,
        "receiveU": 2483374.81975148,
        "receiveFirstTxTime": 1648521562,
        "receiveLatestTxTime": 1648586361,
        "balance": {
            "total": 0.07,
            "details": [
                {
                    "tokenName": "ETH",
                    "tokenAddress": "",
                    "balance": 0.000039,
                    "amount": 0.07
                }
            ]
        }
    }
}

```