Query Parameters

address

array

REQUIRED

List of addresses in any form to get address book. Max: 1024

include_boc

boolean

Include code and data BOCs. Default: true

Returns

accounts

array

An array of account state objects, each representing a unique blockchain account

account_state_hash

string

The hash of the complete state of the account (data, code, balance, etc.)

address

string

The raw blockchain address of the account (e.g., TON address format)

balance

string

The balance of the account, usually in the smallest denomination of the native token

code_boc

string

The serialized BOC (Bag of Cells) representation of the account's smart contract code

code_hash

string

Hash of the account's smart contract code

data_boc

string

The serialized BOC representation of the account's data

data_hash

string

Hash of the account's data section

extra_currencies

object

A map of additional token balances held by the account. Each key represents a currency ID

<dynamic_key>

string

The balance of a specific extra currency, represented as a string

frozen_hash

string

Hash representing a frozen account state, if applicable

last_transaction_hash

string

Base64-encoded hash of the last known transaction for this account

last_transaction_lt

string

Logical time (LT) of the last transaction, used for ordering in the ledger

status

string

Current status of the account (e.g., active, frozen, uninitialized)

address_book

object

A mapping of raw addresses to human-friendly representations

raw_address

object

Each key is a raw blockchain address that maps to a user-friendly entry

domain

string

A custom domain associated with the address (if any)

user_friendly

string

A Base64URL user-friendly version of the raw address, used for easier sharing and display

metadata

object

(Optional) The metadata for addresses, providing additional information:

<dynamic_key>

object

Each key is a raw address and maps to an AddressMetadata object

is_indexed

boolean

Indicates whether this address is indexed in an external indexer or database

token_info

array

A list of token metadata associated with the address

description

string

A description of the token

extra

object

A key-value map of additional metadata for the token

<dynamic_key>

object

Custom field where each key maps to a string value representing extra info

image

string

URL to an image representing the token (e.g., logo)

name

string

Name of the token

symbol

string

Symbol of the token (e.g., BTC, ETH)

type

string

Type/category of the token (e.g., fungible, NFT)

Request

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/api/v3/accountStates?address=UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA' \
2
--header 'accept: application/json'

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/api/v3/accountStates?address=UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA' \
2
--header 'accept: application/json'

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3

4
const requestOptions = {
5
    method: "GET",
6
    headers: myHeaders,
7
    redirect: "follow"
8
};
9

10
fetch("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/accountStates?address=UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA", requestOptions)

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3

4
const requestOptions = {
5
    method: "GET",
6
    headers: myHeaders,
7
    redirect: "follow"
8
};
9

10
fetch("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/accountStates?address=UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA", requestOptions)

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/api/v3/accountStates?address=UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA"
4

5
payload = {}
6
headers = {
7
    'accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/api/v3/accountStates?address=UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA"
4

5
payload = {}
6
headers = {
7
    'accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/accountStates?address=UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["accept"] = "application/json"
9

10
response = http.request(request)

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/accountStates?address=UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["accept"] = "application/json"
9

10
response = http.request(request)

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free