GET
/
getAddressState
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getAddressState
{
  "state": "active"
}

The getAddressState method retrieves the current state of a specific address on the TON blockchain. This method provides a quick way to check whether an address is active, uninitialized, or frozen.

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.

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": "getAddressState",

    "params": {

      "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"

    }

  }'

Parameters

  • address (string, required) — The address for which to retrieve the state. Example: EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2.

Response

  • state (string) — The current state of the address. Possible values are:
    • active: The address is active and can participate in transactions.
    • uninitialized: The address has not been initialized yet (no outgoing transactions).
    • frozen: The address is frozen and cannot participate in transactions.

Use case

A possible use case for the getAddressState method in TON is for wallet applications, blockchain explorers, or smart contract interactions. This method can be used to:

  1. Verify if an address is ready to receive transactions.
  2. Check if a smart contract has been deployed and is active.
  3. Determine if an address needs to be initialized before use.
  4. Monitor the state of important addresses for security or operational purposes.

Query Parameters

address
string
default:EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2
required

The address to get the state for

Response

200 - application/json
The current state of the specified address
state
enum<string>

The current state of the address

Available options:
active,
uninitialized,
frozen