Get extended address information

Returns detailed account information with parsed contract state. For wallet contracts, identifies the wallet version (v3, v4, v5) and extracts wallet-specific fields like seqno and public key. For other contracts, returns the raw state.

POST /api/v2/getExtendedAddressInformation

Get extended address information

cURL

curl --request POST \
  --url https://toncenter.com/api/v2/getExtendedAddressInformation \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "address": "<string>",
  "seqno": "<string>"
}
'

200

{
  "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

APIKeyHeaderAPIKeyQuery

X-API-Key · string · header · required

Body

application/json

address · string · required

The account address in user-friendly format.

seqno · string integer<int32>

Block or wallet sequence number. For blocks, this is the block height. For wallets, increment this for each outgoing transaction.

Response

200

application/json

OK

Response containing extended account information with parsed wallet state.

ok · boolean · default: true · required

Indicates if the request succeeded. If false, check the error field for details.

result · object · required

The response data. Only present when ok is true.

Show child attributes

@extra · string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.