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

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": {
      "data": "<string>"
    },
    "jetton_wallet_code": "<string>",
    "admin_address": "<string>"
  },
  "@extra": "<string>"
}

Authorizations

APIKeyHeaderAPIKeyQuery

X-API-Key · string · header · required

API key header of the form X-API-Key: <token>, where <token> is the API key. Requests without a key are limited to 1 RPS. Refer to the authentication guide for details.

Query Parameters

address · string · required

The account address to query. Account address in raw format (e.g., 0:ca6e321c...) or user-friendly format (e.g., EQDKbjIcfM...). All formats are automatically detected.

Response

200

application/json

Returns parsed token metadata for Jetton masters, Jetton wallets, NFT collections, and NFT items.

ok · boolean · default: true · required

Returns true if the request succeeded; otherwise false. See the error field for details.

result · object · required

Response data. Present only when ok is true.

Option 1

Option 2

Option 3

Option 4

Show child attributes

@extra · string

Optional request ID that can be passed in the request and received back in the response. Useful for matching async responses.