---
title: Assets HTTP API
slug: assets-http-api
docTags: 
createdAt: 2024-11-21T11:30:33.233Z
---

## Assets

:::hint{type="info"}
API Keys can be found at [dtontech\_bot](https://t.me/dtontech_bot)

To use them, just pass API key to url, example:

[https://dton.io/{your\_key}/api/v1/assets/dton.ton](https://dton.io/\{your_key}/graphql)
:::



### Endpoint

**URL**: `/api/v1/assets/<users>/`

**Method**: GET

### Parameters

| Parameter Name | Type   | Description                                                        |
| -------------- | ------ | ------------------------------------------------------------------ |
| users          | String | A single user address or a comma-separated list of user addresses. |

### Behavior

1. **Single User**:
   - When the users parameter contains one address, the API returns all asset data for the specified user.
   - Example: `/api/v1/assets/address`
2. **Multiple Users**:
   - When the users parameter contains multiple addresses (comma-separated), the API returns grouped asset data for all specified users.
   - Example: `/api/v1/assets/address1,address2`

### Response

- **Single User**: A JSON array of asset objects for the user, including related jetton\_info.
- **Multiple Users**: A JSON array of grouped asset objects with user-specific data nested.

***

## Assets Net Worth

### Endpoint

**URL**: `/api/v1/assets/net_worth/<users>/`

**Method**: GET

### Parameters

| Parameter Name | Type   | Description                                                        |
| -------------- | ------ | ------------------------------------------------------------------ |
| users          | String | A single user address or a comma-separated list of user addresses. |

### Response

JSON containing 2 keys - `net_worth_ton`, `net_worth_usd`

```json
{
  "net_worth_ton": Decimal,
  "net_worth_usd": Decimal
}
```

***

## Assets Token Info

### Endpoint

**URL**: `/api/v1/assets/token_info/<address>/`

**Method**: GET

### Parameters

| Parameter Name | Type   | Description                               |
| -------------- | ------ | ----------------------------------------- |
| address        | String | Jetton Master Address or 0:000... for TON |

### Response

JSON containing `TokenInfo` object