TON DocsTON Docs
OnboardingNodesApplicationsAPIsContractsSmart contractsTolkTolk languageTVMTON Virtual MachineFoundationsBlockchain foundations

Get address information

GET
/api/v2/getAddressInformation

Returns the current state of any account on the TON blockchain. Includes the balance (in nanograms), smart contract code and data (if deployed), account status, and a reference to the last transaction. This is the primary endpoint for checking if an address exists and what's deployed there.

Authorization

X-API-Key<token>

API key header of the form X-API-Key: <token>, where <token> is the API key. Requests without a key are limited to 1 RPS. Refer to the authentication guide for details.

In: header

Query Parameters

address*string

The account address to query.

seqno?integer

Query state at a specific block height. If omitted, returns the current state. Use this to look up historical data at a specific point in time.

Formatint32

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v2/getAddressInformation?address=string"
{  "ok": true,  "result": {    "@type": "raw.fullAccountState",    "balance": "string",    "extra_currencies": [      {        "@type": "extraCurrency",        "id": 0,        "amount": "string"      }    ],    "last_transaction_id": {      "@type": "internal.transactionId",      "lt": "string",      "hash": "string"    },    "block_id": {      "@type": "ton.blockIdExt",      "workchain": 0,      "shard": "string",      "seqno": 0,      "root_hash": "string",      "file_hash": "string"    },    "code": "string",    "data": "string",    "frozen_hash": "string",    "sync_utime": 0,    "state": "uninitialized",    "suspended": true  },  "@extra": "string"}