Query Parameters

address

array

REQUIRED

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

Returns

wallets

array

The array of wallet information for each requested address

address

string

The wallet's address in raw format

is_wallet

boolean

The indicator if the address is a wallet contract

balance

string

The current balance of the wallet in nanoTONs

status

string

The current status of the wallet

code_hash

string

The hash of the wallet's smart contract code

last_transaction_hash

string

The hash of the most recent transaction involving this wallet

last_transaction_lt

string

The logical time of the most recent transaction involving this wallet

seqno

integer

(Optional) The current sequence number used for transaction ordering

wallet_id

integer

(Optional) The unique identifier of the wallet within its type

wallet_type

string

(Optional) The type of wallet contract

is_signature_allowed

boolean

(Optional) The indicator if the wallet contract allows signature-based operations

extra_currencies

object | null

(Optional) The dictionary of additional currency balances held by the wallet

<dynamic_key>

object

The currency ID mapping to its balance

address_book

object

(Optional) The mapping of addresses to their human-readable information

<dynamic_key>

object

The blockchain address as a key

user_friendly

string

The human-readable representation of the blockchain address

domain

string | null

The domain name associated with the address if available

metadata

object

(Optional) The metadata information about the addresses

<dynamic_field>

object

The mapping to address metadata object with dynamic keys

is_indexed

boolean

The indicator if the address is indexed in the system

token_info

array

The collection of token information associated with this address

description

string

The detailed description of the token

extra

object

The additional custom token metadata fields

<dynamic_field>

string | number | array | object | null

The custom property with dynamic key for additional token information

image

string

The URL pointing to the token image or icon

name

string

The full name of the token

symbol

string

The short ticker symbol of the token

type

string

The classification or standard of the token

Request

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

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/api/v3/walletStates?address=EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs' \
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/walletStates?address=EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs", 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/walletStates?address=EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs", requestOptions)

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/api/v3/walletStates?address=EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs"
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/walletStates?address=EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs"
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/walletStates?address=EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs")
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/walletStates?address=EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs")
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