Get Jetton wallets

Returns Jetton wallet contracts matching the specified filters. Filter by wallet address, owner address, or Jetton master address. Each result includes balance, owner, and associated Jetton master. Use exclude_zero_balance to skip empty wallets.

GET /api/v3/jetton/wallets

Get Jetton wallets

cURL

curl --request GET \
  --url https://toncenter.com/api/v3/jetton/wallets

200

{
  "address_book": {},
  "jetton_wallets": [
    {
      "address": "<string>",
      "balance": "<string>",
      "code_hash": "<string>",
      "data_hash": "<string>",
      "jetton": "<string>",
      "last_transaction_lt": "0",
      "mintless_info": {
        "amount": "<string>",
        "custom_payload_api_uri": [
          "<string>"
        ],
        "expire_at": 123,
        "start_from": 123
      },
      "owner": "<string>"
    }
  ],
  "metadata": {}
}

Query Parameters

address · string[]

Jetton wallet address in any form. Max: 1000.

owner_address · string[]

Address of Jetton wallet's owner in any form. Max: 1000.

jetton_address · string[]

Jetton Master in any form.

exclude_zero_balance · boolean

Exclude jetton wallets with 0 balance.

limit · integer<int32> · default: 10

Limit number of queried rows. Use with offset to batch read.

Required range: 1 <= x <= 1000

offset · integer<int32> · default: 0

Skip first N rows. Use with limit to batch read.

Required range: x >= 0

sort · enum<string>

Sort jetton wallets by balance. Warning: results may be inconsistent during the read with limit and offset.

Available options: asc, desc

Response

200

application/json

Matching Jetton wallet contracts with address book and metadata.

Response wrapper containing Jetton wallet contracts with address book and token metadata.

address_book · object

Address book mapping raw addresses to user-friendly forms for all addresses referenced in the response.

Show child attributes

jetton_wallets · object[]

Array of Jetton wallet contracts matching the query filters.

Show child attributes

metadata · object

Token and indexing metadata for all addresses referenced in the response.

Show child attributes