GET
/
jetton
/
masters
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/jetton/masters
{
  "masters": [
    {
      "address": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "decimals": 123,
      "totalSupply": "<string>",
      "mintable": true,
      "admin": "<string>",
      "metadata": {},
      "contentUri": "<string>"
    }
  ]
}

The jetton/masters endpoint retrieves a list of Jetton master contracts from the TON blockchain. Jettons are the TON equivalent of fungible tokens (similar to ERC-20 tokens on Ethereum). This endpoint allows you to fetch information about various Jetton types 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 masters to return. Default: 128.
  • offset (integer, optional) — The number of Jetton masters to skip before starting to return results. Default: 0.

​
Response

  • masters (array) — An array of Jetton master objects, each containing:
    • 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.
    • totalSupply (string) — The total supply of the Jetton.
    • mintable (boolean) — Whether new tokens can be minted.
    • admin (string) — The address of the Jetton admin.
    • metadata (object) — Additional metadata of the Jetton.
    • contentUri (string) — The URI of the Jetton’s content.

​
Use case

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

  1. Decentralized exchanges (DEXs) can use this to list available Jettons for trading.
  2. Wallet applications can display Jetton information and allow users to add custom Jettons.
  3. Analytics platforms can gather data on Jetton distribution, total supply, and metadata patterns.
  4. Developers can use this endpoint to integrate Jetton information into their dApps or financial services.
  5. Token creators can verify the on-chain status and details of their published Jettons.
  6. Investors can research and discover new Jettons available on the TON blockchain.

Query Parameters

​
limit
integer
default:128

The maximum number of Jetton masters to return

​
offset
integer
default:0

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

Response

200 - application/json
Successful response
​
masters
object[]