Get detailed account state (extended)

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

Try it

Get detailed account state (extended)

cURL

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

200

{
  "ok": true,
  "result": {
    "balance": "<string>",
    "last_transaction_id": {
      "lt": "<string>",
      "hash": "<string>",
      "@type": "internal.transactionId"
    },
    "@type": "fullAccountState",
    "address": {
      "account_address": "<string>",
      "@type": "accountAddress"
    },
    "extra_currencies": [
      {}
    ],
    "block_id": {
      "workchain": 123,
      "shard": "<string>",
      "seqno": 123,
      "root_hash": "<string>",
      "file_hash": "<string>",
      "@type": "ton.blockIdExt"
    },
    "sync_utime": 123,
    "account_state": {
      "@type": "wallet.v3.accountState",
      "wallet_id": "<string>",
      "seqno": 123
    },
    "revision": 123,
    "@extra": "<string>"
  },
  "error": "<string>",
  "code": 123
}

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

result. balance · string · required

result. last_transaction_id · object · required

Internal transaction identifier.

Show child attributes

result.last_transaction_id. lt · string · required

Logical time.

result.last_transaction_id. hash · string · required

Base64 hash of the tx.

result.last_transaction_id. @type · string

Example:

"internal.transactionId"

result. @type · string

Example:

"fullAccountState"

result. address · object

Account address object.

Show child attributes

result.address. account_address · string · required

Friendly address string.

result.address. @type · string

Example:

"accountAddress"

result. extra_currencies · object[]

result. block_id · object

Extended block identifier.

Show child attributes

result.block_id. workchain · integer · required

result.block_id. shard · string · required

64-bit signed integer as string

result.block_id. seqno · integer · required

result.block_id. root_hash · string · required

result.block_id. file_hash · string · required

result.block_id. @type · string

Example:

"ton.blockIdExt"

result. sync_utime · integer

result. account_state · object

Decoded state depending on contract type. For wallets, may include wallet_id and seqno.

Show child attributes

result.account_state. @type · string

Example:

"wallet.v3.accountState"

result.account_state. wallet_id · string

result.account_state. seqno · integer

result. revision · integer

result. @extra · string

error · string

code · integer