> ## 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.

# jetton/masters | TON v3

> The jetton/masters endpoint retrieves a list of Jetton master contracts from the TON blockchain. Available on TON v3 via Chainstack.

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.

<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

* `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.


## OpenAPI

````yaml openapi/ton_node_api/v3/getJettonMasters.json GET /jetton/masters
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:
  /jetton/masters:
    get:
      tags:
        - Jetton
      summary: Get Jetton Masters
      description: Retrieves a list of Jetton master contracts from the TON blockchain
      operationId: getJettonMasters
      parameters:
        - name: limit
          in: query
          description: The maximum number of Jetton masters to return
          required: false
          schema:
            type: integer
            default: 128
        - name: offset
          in: query
          description: >-
            The number of Jetton masters to skip before starting to return
            results
          required: false
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  masters:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                          type: string
                          description: The address of the Jetton master contract
                        name:
                          type: string
                          description: The name of the Jetton
                        symbol:
                          type: string
                          description: The symbol of the Jetton
                        decimals:
                          type: integer
                          description: The number of decimal places for the Jetton
                        totalSupply:
                          type: string
                          description: The total supply of the Jetton
                        mintable:
                          type: boolean
                          description: Whether new tokens can be minted
                        admin:
                          type: string
                          description: The address of the Jetton admin
                        metadata:
                          type: object
                          description: Additional metadata of the Jetton
                        contentUri:
                          type: string
                          description: The URI of the Jetton's content

````