GET
/
getAddressInformation
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getAddressInformation
{
  "balance": "<string>",
  "state": "<string>",
  "code": "<string>",
  "data": "<string>",
  "last_transaction_id": {
    "lt": "<string>",
    "hash": "<string>"
  },
  "error": {},
  "id": 123
}

The getAddressInformation method retrieves information about a specific address on the TON blockchain. This includes details such as the balance, state, code, and data associated with the address, as well as the last transaction ID.

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

TON pricing is the same for full, archive, v2, v3

There’s no difference between a full node an archive node in data availability or pricing.
All data is always available and all node requests are consumed as 1 request unit.

Parameters

  • address (string, required) — The address for which information is being requested. Example: EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2.
  • seqno (int, optional) — the Masterchain seqno. You can get the Masterchain seqno with getMasterchainInfo | TON v2.

Example with seqno:

Shell
curl --request GET \

     --url 'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getAddressInformation?address=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2&seqno=45792554' \

     --header 'accept: application/json'

JSON-RPC example

Shell
curl -X POST \

  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \

  -H 'Content-Type: application/json' \

  -d '{

    "jsonrpc": "2.0",

    "id": 1,

    "method": "getAddressInformation",

    "params": {

      "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"

    }

  }'

Response

  • balance (string) — The balance of the address.
  • state (string) — The state of the address.
  • code (string) — The code of the address.
  • data (string) — The data of the address.
  • last_transaction_id (object) — The last transaction ID, containing:
    • lt (string) — The logical time of the last transaction.
    • hash (string) — The hash of the last transaction.
  • error (object) — Error information, if any.
  • id (integer) — The request ID.

Use case

A possible use case for the getAddressInformation method in TON is for applications that need to display or utilize the current state and balance of a specific address. For example, a wallet application may use this method to show the user’s balance and transaction history.

Query Parameters

address
string
default:EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2
required

The address to get information for

Response

200 - application/json
Information about the specified address
balance
string

The balance of the address

state
string

The state of the address

code
string

The code of the address

data
string

The data of the address

last_transaction_id
object
error
object
id
integer