GET
/
jetton
/
transfers
Get Jetton Transfers
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/jetton/transfers
{
  "transfers": [
    {
      "jetton": {
        "address": "<string>",
        "name": "<string>",
        "symbol": "<string>"
      },
      "from": {
        "address": "<string>"
      },
      "to": {
        "address": "<string>"
      },
      "transaction": {
        "hash": "<string>",
        "time": 123
      },
      "amount": "<string>",
      "comment": "<string>"
    }
  ]
}
The jetton/transfers endpoint retrieves a list of Jetton transfers from the TON blockchain. This endpoint allows you to fetch information about Jetton transfer activities and provides options for filtering, pagination, and sorting.
Get you own node endpoint todayStart 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, v3There’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

  • direction (string, required) — The direction of transfers to retrieve. Possible values: in, out, or both. Default: both.
  • limit (integer, optional) — The maximum number of transfers to return. Default: 128.
  • offset (integer, optional) — The number of transfers to skip before starting to return results. Default: 0.
  • sort (string, optional) — The sorting order of the transfers. Possible values: asc (ascending) or desc (descending). Default: desc.

​
Response

  • transfers (array) — An array of Jetton transfer objects, each containing:
    • jetton (object) — Information about the transferred Jetton:
      • address (string) — The address of the Jetton master contract.
      • name (string) — The name of the Jetton.
      • symbol (string) — The symbol of the Jetton.
    • from (object) — Information about the sender:
      • address (string) — The address of the sender.
    • to (object) — Information about the recipient:
      • address (string) — The address of the recipient.
    • transaction (object) — Information about the transaction:
      • hash (string) — The hash of the transaction.
      • time (integer) — The timestamp of the transaction.
    • amount (string) — The amount of Jettons transferred.
    • comment (string) — Any comment attached to the transfer.

​
Use case

The jetton/transfers endpoint is useful for various applications that need to track or analyze Jetton transfer activities on the TON blockchain:
  1. Wallet applications can show users their history of Jetton transactions.
  2. Decentralized exchanges (DEXs) can use this to display recent trades or transfers of Jettons.
  3. Analytics platforms can track Jetton transfer patterns, popular tokens, and market trends.
  4. Developers can use this endpoint to build notification systems for Jetton transfers.
  5. Compliance tools can use this data to monitor large transfers or specific addresses.
  6. Portfolio tracking applications can use this to update users’ Jetton balances in real-time.

Query Parameters

​
direction
enum<string>
default:both
required

The direction of transfers to retrieve

Available options:
in,
out,
both
​
limit
integer
default:128

The maximum number of transfers to return

​
offset
integer
default:0

The number of transfers to skip before starting to return results

​
sort
enum<string>
default:desc

The sorting order of the transfers

Available options:
asc,
desc

Response

200 - application/json

Successful response

The response is of type object.