Skip to main content
GET
/
addressInformation
Get Address Information
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/addressInformation
{
  "balance": "<string>",
  "code": "<string>",
  "data": "<string>",
  "last_transaction_lt": "<string>",
  "last_transaction_hash": "<string>",
  "status": "<string>"
}

​
Address Information

The addressInformation endpoint retrieves detailed information about a smart contract address, including its balance, code, and data cells.
Get you own node endpoint todayStart 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, v3There’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 account address to query.

​
Response

  • balance (string) — Account balance in nanotons.
  • code (string) — Smart contract code in base64 format.
  • data (string) — Smart contract data in base64 format.
  • last_transaction_lt (string) — Logical time of last transaction.
  • last_transaction_hash (string) — Hash of last transaction.
  • status (string) — Account status (active, uninit, frozen).

​
Use case

The addressInformation endpoint is useful for applications that need complete contract details:
  1. Block explorers displaying full contract information.
  2. Smart contract analysis tools examining code and data.
  3. Wallet applications verifying contract state.
  4. Development tools debugging contract behavior.
  5. Security audits examining deployed contracts.
Here’s an example of getting address information: 
curl -X GET \
  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/addressInformation?address=EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs' \
  -H 'accept: application/json'
This endpoint returns the raw code and data cells. Use runGetMethod to interact with the contract’s get methods for parsed data.

Query Parameters

​
address
string
default:EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs
required

Account address to query

Response

200 - application/json

Successful response

​
balance
string

Account balance in nanotons

​
code
string

Smart contract code in base64

​
data
string

Smart contract data in base64

​
last_transaction_lt
string

Last transaction logical time

​
last_transaction_hash
string

Last transaction hash

​
status
string

Account status