Skip to main content
GET
/
api
/
v3
/
jetton
/
transfers
Get Jetton transfers
curl --request GET \
  --url https://toncenter.com/api/v3/jetton/transfers
{
  "address_book": {},
  "jetton_transfers": [
    {
      "amount": "<string>",
      "custom_payload": "<string>",
      "decoded_custom_payload": [
        123
      ],
      "decoded_forward_payload": [
        123
      ],
      "destination": "<string>",
      "forward_payload": "<string>",
      "forward_ton_amount": "<string>",
      "jetton_master": "<string>",
      "query_id": "<string>",
      "response_destination": "<string>",
      "source": "<string>",
      "source_wallet": "<string>",
      "trace_id": "<string>",
      "transaction_aborted": true,
      "transaction_hash": "<string>",
      "transaction_lt": "0",
      "transaction_now": 123
    }
  ],
  "metadata": {}
}

Query Parameters

​
owner_address
string[]

Address of jetton wallet owner in any form. Max 1000

​
jetton_wallet
string[]

Jetton wallet address in any form. Max: 1000.

​
jetton_master
string

Jetton master address in any form.

​
direction
enum<string>

Direction of transfer. Note: applied only with owner_address.

Available options:
in,
out
​
start_utime
integer<int32>

Query transactions with generation UTC timestamp after given timestamp.

Required range: x >= 0
​
end_utime
integer<int32>

Query transactions with generation UTC timestamp before given timestamp.

Required range: x >= 0
​
start_lt
integer<int64>

Query transactions with lt >= start_lt.

Required range: x >= 0
​
end_lt
integer<int64>

Query transactions with lt <= end_lt.

Required range: x >= 0
​
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>
default:desc

Sort transactions by lt.

Available options:
asc,
desc

Response

200 - application/json

Matching Jetton transfer events with address book and metadata.

Response wrapper containing Jetton transfer events 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.

​
jetton_transfers
object[]

Array of Jetton transfer events matching the query filters.

​
metadata
object

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