Skip to main content
POST
/
api
/
v2
/
getExtendedAddressInformation
Get extended address information
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>"
}
'
{
  "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

Body

application/json
​
address
string
required

The account address in user-friendly format.

​
seqno

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

Response

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.

​
@extra
string

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