Assets Field Descriptions
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 | Metadata about the token. See TokenInfo details below |
by_user | List[ByUser] | User-specific aggregated data for each asset. See ByUser 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
JettonAssetType
StakingAssetType
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 | References a raw binary content object for the token, if applicable. See 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 |