Get Extended Address Information

Similar to previous one but tries to parse additional information for known contract types. This method is based on tonlib’s function getAccountState. For detecting wallets we recommend to use getWalletInformation.

GET /getExtendedAddressInformation

Get Extended Address Information

cURL

curl --request GET \
  --url https://toncenter.com/api/v2/getExtendedAddressInformation

import requests

url = "https://toncenter.com/api/v2/getExtendedAddressInformation"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://toncenter.com/api/v2/getExtendedAddressInformation', 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://toncenter.com/api/v2/getExtendedAddressInformation",
  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://toncenter.com/api/v2/getExtendedAddressInformation"

	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://toncenter.com/api/v2/getExtendedAddressInformation")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://toncenter.com/api/v2/getExtendedAddressInformation")

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

200

{
  "ok": true,
  "result": {
    "@type": "fullAccountState",
    "address": {
      "@type": "accountAddress",
      "account_address": "EQCD39VS5jcptHL8vMjEXrzGaRcCVYto7HUn4bpAOg8xqB2N"
    },
    "balance": "1592521995920473",
    "extra_currencies": [],
    "last_transaction_id": {
      "@type": "internal.transactionId",
      "lt": "60294179000005",
      "hash": "opzfb6lX3inMMTbyvp8Z/FmrrdgZ4D/NPZvDZOkjd0E="
    },
    "block_id": {
      "@type": "ton.blockIdExt",
      "workchain": -1,
      "shard": "-9223372036854775808",
      "seqno": 50940791,
      "root_hash": "8Zcn3qPdpJY5nBOIOG5h/v3ABrPRQoahCOgbSmmICS0=",
      "file_hash": "BLvAHAZGs/Zoozhdsn5VvADALGQc+CoaQBSUqj1tKWo="
    },
    "sync_utime": 1755283118,
    "account_state": {
      "@type": "wallet.v3.accountState",
      "wallet_id": "698983191",
      "seqno": 341
    },
    "revision": 2,
    "@extra": "1755283135.0102983:6:0.11795169251963"
  }
}

Query Parameters

address · string · required

Identifier of target TON account in any form.

Response

200

application/json

Successful Response

ok · boolean · required

result · Result · object

Generic account state decoded by tonlib; contract-specific account_state may contain typed fields (e.g., wallet.v3.accountState).

Show child attributes

error · string

code · integer