getAddressInformation - Ton

getAddressInformation. Provides detailed information about a specified TON blockchain address, including its status and balance

getAddressInformation - ton [Value: 100CU]
Provides detailed information about a specified TON blockchain address, including its status and balance
Use cases

Use cases

  • Retrieve information about a specific TON address
  • Check balance and transaction history for an address
  • Validate the existence and status of a TON address
Constraints

Constraints

  • Requires a valid TON address as input
  • Only provides information for active addresses
  • Depends on the node's and network synchronization
Get started
Unlock Access to 50+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --request GET \
     --url  https://ton.drpc.org/rest/getAddressInformation?address=0:1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef \
     --header 'accept: application/json'
Copy
Response
200

    "ok": true,
    "result": {
        "@type": "raw.fullAccountState",
        "balance": 0,
        "code": "",
        "data": "",
        "last_transaction_id": {
            "@type": "internal.transactionId",
            "lt": "0",
            "hash": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="
        },
        "block_id": {
            "@type": "ton.blockIdExt",
            "workchain": -1,
            "shard": "-9223372036854775808",
            "seqno": 41577780,
            "root_hash": "RQF+aoHWjFzZFLlYC0FUfReFqHFxNC8V5D9EdBVBDFU=",
            "file_hash": "aQqXj3RteZH5OoW711kHIhsXVpNcAV2RRYUnK2+CDBc="
        },
        "frozen_hash": "",
        "sync_utime": 1730406343,
        "@extra": "1730406360.2390494:0:0.38994098956920675",
        "state": "uninitialized"
    }
}
Copy

Request params

Parametersstring
string
addressstring
Identifier of the target TON account in any form.

Response

200

Response params

object
okboolean
Indicates if the request was successful.
resultobject
The detailed account state result.
object
@typestring
The type of the account state representation.
balanceinteger
The balance of the account.
codestring
The contract code associated with the account.
datastring
The data stored in the account.
last_transaction_idobject
The ID of the last transaction made by the account.
object
@typestring
The type of the transaction ID.
ltstring
The logical timestamp of the transaction.
hashstring
The hash of the last transaction.
block_idobject
Details of the block in which the last transaction was included.
object
@typestring
The type of block ID.
workchaininteger
The workchain ID of the block.
shardstring
The shard ID of the block.
seqnointeger
The sequence number of the block.
root_hashstring
The root hash of the block.
file_hashstring
The file hash of the block.
frozen_hashstring
The frozen hash of the account.
sync_utimeinteger
The synchronization time of the account state.
@extrastring
Additional metadata related to the response.
statestring
The state of the account (e.g., uninitialized).
Account infogetExtendedAddressInformation