GET
/
getTokenData
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getTokenData
{
  "name": "<string>",
  "symbol": "<string>",
  "decimals": 123,
  "totalSupply": "<string>",
  "mintable": true,
  "burnable": true,
  "address": "<string>"
}

The getTokenData method retrieves data about a specific token on the TON blockchain. This method is useful for obtaining detailed information about TON-based tokens, including their name, symbol, supply, and other characteristics.

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

TON pricing is the same for full, archive, v2, v3

There’s no difference between a full node an archive node in data availability or pricing.
All data is always available and all node requests are consumed as 1 request unit.

​
Parameters

  • address (string, required) — The address of the token contract. Example: EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs.

​
JSON-RPC example

Shell
curl -X POST \

  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \

  -H 'Content-Type: application/json' \

  -d '{

    "jsonrpc": "2.0",

    "id": 1,

    "method": "unpackAddress",

    "params": {

      "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"

    }

  }'

​
Response

  • name (string) — The name of the token.
  • symbol (string) — The symbol or ticker of the token.
  • decimals (integer) — The number of decimal places for the token.
  • totalSupply (string) — The total supply of the token.
  • mintable (boolean) — Indicates whether new tokens can be minted.
  • burnable (boolean) — Indicates whether tokens can be burned (destroyed).
  • address (string) — The address of the token contract.

​
Use case

A possible use case for the getTokenData method in TON is for applications that deal with TON-based tokens, such as:

  1. Wallet applications displaying token information to users.
  2. Decentralized exchanges (DEXs) fetching token data for listing and trading purposes.
  3. Block explorers providing detailed token information.
  4. DApps that need to interact with various tokens and require their metadata.

Query Parameters

​
address
string
default:EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs
required

The address of the token contract

Response

200 - application/json
Data about the specified token
​
name
string

The name of the token

​
symbol
string

The symbol of the token

​
decimals
integer

The number of decimal places for the token

​
totalSupply
string

The total supply of the token

​
mintable
boolean

Whether the token is mintable

​
burnable
boolean

Whether the token is burnable

​
address
string

The address of the token contract