Assets

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

The current balance of the asset in its smallest unit

estimate_ton

Decimal

The estimated value of the asset in TON

estimate_usd

Decimal

The estimated value of the asset in USD

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

nft_address

String (Optional)

Address of the NFT associated with staking



Asset-Specific Fields

These fields are available only within their respective asset types.

TonAssetType

Field Name

Type

Description

token_info

TokenInfo

Metadata about the TON. See TokenInfo details below

JettonAssetType

Field Name

Type

Description

token_info

TokenInfo

Metadata about the Jetton. See TokenInfo details below

jetton_wallet_address

String

Address of the wallet holding the Jetton asset

StakingAssetType

Field Name

Type

Description

token_info

TokenInfo

Metadata about the Staked Token. See TokenInfodetails below

provider

String

The staking provider (e.g., Whales, DeDust, StonFI)

nft_address

String (Optional)

Address of the NFT associated with staking



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

References a raw binary content object for the token, if applicable. See BinaryContent details below

estimate_ton

Decimal (Optional)

The estimated value of the asset in TON

estimate_usd

Decimal (Optional)

The estimated value of the asset in USD

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