> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# walletStates | TON v3

> The walletStates endpoint queries wallet state information for addresses, including balance, status, and whether the address is a recognized wallet contract.

# Wallet States

The `walletStates` endpoint queries wallet state information for addresses, including balance, status, and whether the address is a recognized wallet contract.

<Note>
  **TON billing: full (1 RU)**

  This method is always billed as full. See [Request units — TON method scope](/docs/request-units#ton-method-scope).
</Note>

## Parameters

* `address` (string, required) — The wallet address to query.
* `limit` (integer, optional) — Maximum number of results. Default: `10`.
* `offset` (integer, optional) — Number of results to skip. Default: `0`.

## Response

* `wallets` (array) — Array of wallet state objects:
  * `address` (string) — Wallet address.
  * `is_wallet` (boolean) — Whether the address is a recognized wallet contract.
  * `balance` (string) — Balance in nanotons.
  * `status` (string) — Account status (active, uninit, frozen).
  * `code_hash` (string) — Hash of the code cell.
  * `last_transaction_hash` (string) — Hash of last transaction.
  * `last_transaction_lt` (string) — Logical time of last transaction.

* `address_book` (object) — Address book mapping with names for known addresses.

## Use case

The `walletStates` endpoint is useful for applications working with wallet contracts:

1. Wallet applications displaying account status and balance.
2. Portfolio trackers monitoring multiple addresses.
3. Payment systems verifying wallet state before transactions.
4. Block explorers identifying wallet types.
5. Analytics tools categorizing addresses as wallets vs contracts.

Here's an example of getting wallet state:

<CodeGroup>
  ```shell shell theme={"system"}
  curl -X GET \
    'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/walletStates?address=EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs' \
    -H 'accept: application/json'
  ```
</CodeGroup>

<Tip>
  The `is_wallet` field indicates whether the contract matches a known wallet implementation (v3, v4, etc.). Jetton masters and other contracts will show `false`.
</Tip>


## OpenAPI

````yaml openapi/ton_node_api/v3/getWalletStates.json GET /walletStates
openapi: 3.0.0
info:
  title: TON API
  version: 3.0.0
  description: API for interacting with The Open Network (TON) blockchain
servers:
  - url: >-
      https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3
security: []
paths:
  /walletStates:
    get:
      tags:
        - Accounts
      summary: Get Wallet States
      description: Query wallet states for addresses
      operationId: getWalletStates
      parameters:
        - name: address
          in: query
          description: Wallet address to query
          required: true
          schema:
            type: string
            default: EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs
        - name: limit
          in: query
          description: Maximum number of results
          schema:
            type: integer
            default: 10
        - name: offset
          in: query
          description: Number of results to skip
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  wallets:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                          type: string
                          description: Wallet address
                        is_wallet:
                          type: boolean
                          description: Whether address is a wallet contract
                        balance:
                          type: string
                          description: Balance in nanotons
                        status:
                          type: string
                          description: Account status
                        code_hash:
                          type: string
                          description: Code cell hash
                        last_transaction_hash:
                          type: string
                          description: Last transaction hash
                        last_transaction_lt:
                          type: string
                          description: Last transaction logical time
                  address_book:
                    type: object
                    description: Address book mapping

````