getTokenData
curl --request GET \
--url https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenDataimport requests
url = "https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenData"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenData', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenData",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenData"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenData")
.asString();require 'uri'
require 'net/http'
url = URI("https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenData")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"name": "<string>",
"symbol": "<string>",
"decimals": 123,
"totalSupply": "<string>",
"mintable": true,
"burnable": true,
"address": "<string>"
}TON node API
getTokenData | TON v2
The getTokenData method retrieves data about a specific token on the TON blockchain. Available on TON v2 via Chainstack JSON-RPC nodes.
GET
/
getTokenData
getTokenData
curl --request GET \
--url https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenDataimport requests
url = "https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenData"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenData', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenData",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenData"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenData")
.asString();require 'uri'
require 'net/http'
url = URI("https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTokenData")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"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 your own node endpoint todayStart 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 billing: full (1 RU)This method is always billed as full. See Request units — TON method scope.
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/mt_c524ad9781ae5dccd9ac6f5b0370e/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 thegetTokenData method in TON is for applications that deal with TON-based tokens, such as:
- Wallet applications displaying token information to users.
- Decentralized exchanges (DEXs) fetching token data for listing and trading purposes.
- Block explorers providing detailed token information.
- DApps that need to interact with various tokens and require their metadata.
Query Parameters
Response
200 - application/json
Data about the specified token
Last modified on November 6, 2026
Was this page helpful?