Skip to main content
GET
/
api
/
v2
/
getExtendedAddressInformation
Get extended address information
curl --request GET \
  --url https://toncenter.com/api/v2/getExtendedAddressInformation \
  --header 'X-API-Key: <api-key>'
{
  "ok": true,
  "result": {
    "@type": "fullAccountState",
    "address": {
      "@type": "accountAddress",
      "account_address": "<string>"
    },
    "balance": "<string>",
    "extra_currencies": [
      {
        "@type": "extraCurrency",
        "id": 123,
        "amount": "<string>"
      }
    ],
    "last_transaction_id": {
      "@type": "internal.transactionId",
      "lt": "<string>",
      "hash": "<string>"
    },
    "block_id": {
      "@type": "ton.blockIdExt",
      "workchain": 123,
      "shard": "<string>",
      "seqno": 123,
      "root_hash": "<string>",
      "file_hash": "<string>"
    },
    "sync_utime": 123,
    "account_state": {
      "@type": "raw.accountState",
      "code": "<string>",
      "data": "<string>",
      "frozen_hash": "<string>"
    },
    "revision": 123
  },
  "@extra": "<string>"
}

Authorizations

​
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.

​
seqno
integer<int32>

Query state at a specific block height. If omitted, returns the current state. Use this to look up historical data at a specific point in time.

Response

Returns detailed account information including parsed contract state and type.

​
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.

​
@extra
string

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