---
title: Assets Field Descriptions
slug: assets-field-descriptions
docTags:
createdAt: 2024-11-21T11:30:27.820Z
---
## Common Fields (Non-Specific to Asset Type)
These fields can be queried at both the top level of the response or nested within individual assets.
| Field Name | Type | Description |
| --------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `asset_address` | String | Address of the asset |
| `user_address` | String | Address of the asset owner |
| `balance` | Decimal | Current balance of the asset in its smallest unit |
| `estimate_ton` | Decimal | Estimated value of the asset in TON (10 \*\* 9) |
| `estimate_usd` | Decimal | Estimated value of the asset in USD (10 \*\* 6) |
| `value_usd` | Decimal | Estimated value of the position (normalized balance \* estimate\_usd) in USD (10 \*\* 6) |
| `token_info` | [TokenInfo](./#tokeninfo) | Metadata about the token. See [TokenInfo](./#tokeninfo) details below |
| `by_user` | List\[[ByUser](docId\:JA8FzW9LWS4pPdnUHoXkC)] | User-specific aggregated data for each asset. See [ByUser](docId\:JA8FzW9LWS4pPdnUHoXkC) details below |
### ByUser
The by\_user field contains data aggregated per user for the specified asset.
| Field Name | Type | Description |
| ----------------------- | ----------------- | ---------------------------------------------- |
| `user_address` | String | The user's wallet address |
| `balance` | String | The user's balance for this asset |
| `jetton_wallet_address` | String (Optional) | Address of the wallet holding the Jetton asset |
| `pool_address` | String (Optional) | Address of the pool |
***
## Asset-Specific Fields
These fields are available only within their respective asset types.
### TonAssetType
| Field Name | Type | Description |
| ------------ | ------------------------- | ------------------------------------------------------------------- |
| `token_info` | [TokenInfo](./#tokeninfo) | Metadata about the TON. See [TokenInfo](./#tokeninfo) details below |
### JettonAssetType
| Field Name | Type | Description |
| ----------------------- | ------------------------- | ---------------------------------------------------------------------- |
| `token_info` | [TokenInfo](./#tokeninfo) | Metadata about the Jetton. See [TokenInfo](./#tokeninfo) details below |
| `jetton_wallet_address` | String | Address of the wallet holding the Jetton asset |
### StakingAssetType
| Field Name | Type | Description |
| -------------- | ------------------------- | --------------------------------------------------------------------------- |
| `token_info` | [TokenInfo](./#tokeninfo) | Metadata about the Staked Token. See [TokenInfo](./#tokeninfo)details below |
| `provider` | String | The staking provider (e.g., Whales, DeDust, StonFI) |
| `pool_address` | String (Optional) | Address of the pool |
***
## TokenInfo
| Field Name | Type | Description |
| ---------------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `address` | String | Jetton Master Address |
| `total_supply` | Decimal | The total supply of the token in its smallest unit |
| `active_wallets_count` | BigInteger | The number of active wallets holding the Jetton |
| `name` | String (Optional) | The name of the token |
| `description` | String (Optional) | A description or details about the token |
| `image` | String (Optional) | A URL to the token's image |
| `image_data` | String (Optional) | Base64-encoded image data for the token |
| `symbol` | String (Optional) | The symbol or shorthand representation of the Jetton token |
| `decimals` | String (Optional) | The number of decimals the token uses for precision |
| `amount_style` | String (Optional) | Specifies how amounts are styled or displayed |
| `render_type` | String (Optional) | Indicates the rendering type or method for the token |
| `social` | List\[String] | A list of social media links or profiles related to the Jetton |
| `websites` | List\[String] | A list of associated websites for the token |
| `is_whitelist` | Boolean | Whether the Jetton is whitelisted (true/false) |
| `binary_content` | [BinaryContent](./#binarycontent) | References a raw binary content object for the token, if applicable. See [BinaryContent](./#binarycontent) details below |
| `estimate_ton` | Decimal (Optional) | Estimated value of the asset in TON
(10 \*\* 9) |
| `estimate_usd` | Decimal (Optional) | Estimated value of the asset in USD
(10 \*\* 6) |
| `token_type` | String | The type of token, one of the following:
- native (TON)
- jetton (Jetton token)
- liquid\_staking (Staked Token)
- liquid\_pool (LP token) |
| `provider` | String (Optional) | Liquid Pool specific field. DeDust / StonFI |
| `pool_info` | JSONField (Optional) | Liquid Pool specific field. TokenInfo objects for `asset0` and \`asset1 |
### BinaryContent
| Field Name | Type | Description |
| ---------------- | --------- | ------------------------------------------------- |
| `url` | String | Original URL of the content |
| `icon_view` | String | 64x64 centered icon version of the file |
| `card_view` | String | 350x350 centered card version of the file |
| `full_view` | String | Full-resolution view of the file (650x or larger) |
| `icon_view_size` | Integer | The file size (in bytes) of the icon\_view |
| `card_view_size` | Integer | The file size (in bytes) of the card\_view |
| `full_view_size` | Integer | The file size (in bytes) of the full\_view |
| `ml_is_nsfw` | Boolean | Indicates whether the file is flagged as NSFW |
| `ml_nsfw` | JSONField | Detailed metadata about NSFW content |