Get token data

Returns metadata for Jetton or NFT contracts. Automatically detects the contract type and returns appropriate fields. For Jetton masters: total supply, admin, metadata. For Jetton wallets: balance, owner. For NFT items: collection, owner, content. For NFT collections: item count, metadata.

GET /api/v2/getTokenData

Try it

Get token data

cURL

curl --request GET \
  --url https://toncenter.com/api/v2/getTokenData \
  --header 'X-API-Key: <api-key>'

200

{
  "ok": true,
  "result": {
    "@type": "ext.tokens.jettonMasterData",
    "address": "<string>",
    "contract_type": "jetton_master",
    "total_supply": "<string>",
    "mintable": true,
    "jetton_content": {
      "type": "onchain",
      "data": "<string>"
    },
    "jetton_wallet_code": "<string>",
    "admin_address": "<string>"
  },
  "@extra": "<string>"
}

Authorizations

X-API-Key · string · header · required

Query Parameters

address · string · required

The account address to query. You can use any format: raw (0:abcd), base64 (EQ), or base64url (UQ). The API automatically detects and converts the format. A TON account address. Accepts raw format (workchain:hex like 0:abc...), base64 bounceable (EQ...), base64 non-bounceable (UQ...), or base64url. All formats are automatically detected.

Response

200

application/json

OK

Response containing Jetton or NFT token metadata.

ok · boolean · default: true · required

Indicates if the request succeeded. If false, check the error field for details.

result · object · required

The response data. Only present when ok is true.

Option 1

Show child attributes

result. @type · enum<string> · default: ext.tokens.jettonMasterData · required

Object type identifier.

Available options: ext.tokens.jettonMasterData

result. address · string · required

The account address in user-friendly format.

result. contract_type · enum<string> · default: jetton_master · required

Type of token contract: jetton_master, jetton_wallet, nft_collection, or nft_item.

Available options: jetton_master

result. total_supply · string · required

Total number of tokens in existence, in the smallest unit. Divide by 10^decimals for human-readable amount.

result. mintable · boolean · required

Whether new tokens can still be created. If false, the total supply is permanently fixed.

result. jetton_content · object · required

Token metadata: name, symbol, decimals, description, image URL.

Show child attributes

result.jetton_content. type · enum<string> · required

Content encoding type.

Available options: onchain, offchain

result.jetton_content. data · required

Raw transaction or contract data in BOC (Bag of Cells) format, base64 encoded.

result. jetton_wallet_code · string · required

Code used to deploy user wallets for this token. Used to verify wallet authenticity.

result. admin_address · string

Address that can mint new tokens or change settings. May be empty if admin rights were revoked.

@extra · string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.