GET
/
jetton
/
wallets
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/jetton/wallets
{
  "wallets": [
    {
      "address": "<string>",
      "balance": "<string>",
      "owner": "<string>",
      "jetton": {
        "address": "<string>",
        "name": "<string>",
        "symbol": "<string>",
        "decimals": 123
      }
    }
  ]
}

The jetton/wallets endpoint retrieves a list of Jetton wallets from the TON blockchain. Jetton wallets are smart contracts that hold balances of specific Jettons for users. This endpoint allows you to fetch information about various Jetton wallets and provides options for pagination.

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

TON pricing is the same for full, archive, v2, v3

There’s no difference between a full node an archive node in data availability or pricing.
All data is always available and all node requests are consumed as 1 request unit.

​
Parameters

  • limit (integer, optional) — The maximum number of Jetton wallets to return. Default: 128.
  • offset (integer, optional) — The number of Jetton wallets to skip before starting to return results. Default: 0.

​
Response

  • wallets (array) — An array of Jetton wallet objects, each containing:
    • address (string) — The address of the Jetton wallet.
    • balance (string) — The balance of the Jetton wallet.
    • owner (string) — The address of the wallet owner.
    • jetton (object) — Information about the Jetton:
      • address (string) — The address of the Jetton master contract.
      • name (string) — The name of the Jetton.
      • symbol (string) — The symbol of the Jetton.
      • decimals (integer) — The number of decimal places for the Jetton.

​
Use case

The jetton/wallets endpoint is useful for various applications that need to interact with or display information about Jetton holdings on the TON blockchain:

  1. Wallet applications can use this to display users’ Jetton balances across different tokens.
  2. Decentralized exchanges (DEXs) can fetch users’ Jetton wallet information for trading purposes.
  3. Analytics platforms can gather data on Jetton distribution and user holdings.
  4. Developers can use this endpoint to integrate Jetton wallet information into their dApps or financial services.
  5. Portfolio tracking applications can use this to monitor users’ Jetton holdings.
  6. Compliance tools can use this data to track Jetton transactions and holdings for specific addresses.

Query Parameters

​
limit
integer
default:128

The maximum number of Jetton wallets to return

​
offset
integer
default:0

The number of Jetton wallets to skip before starting to return results

Response

200 - application/json

Successful response

The response is of type object.