Transactions - apiTON

Transactions of an address, newest first, with decoded messages: operation names, jetton and NFT transfer details. Backed by the historical archive, so it reaches beyond the liteservers' ~1 month.

Request. address (.ton names allowed), limit (≤ 100, default 10), start_after_tx + start_after_lt (cursor), end_before_lt (stop at this logical time).

Paging. Take tx and lt of the last transaction of a page and send them as start_after_tx / start_after_lt; the next page starts strictly after it. A page holds limit transactions unless the history ends.

Messages. in / out carry operation, op_code, amount, symbol, from, to, body and, for NFT / jetton transfers, details (item name, image, collection, jetton master). amount is in the unit symbol names: TON for the coin, the jetton's units for JettonTransfer, JettonInternalTransfer, JettonNotify and JettonBurn, whose TON goes to attached_ton_amount. A message whose jetton amount cannot be read (excesses, a body that does not decode) keeps the TON as amount with symbol TON. body is the raw message body as a base64 BOC; a text comment is op 0 followed by the text. Until 2026-11-04 jetton messages carried the attached TON under the jetton's symbol; fixed. One request looks up at most 40 NFT items / jetton wallets for details; on a page with more, the rest come without details (symbol TON) — asking again fills in more.

Labels. labels maps every labelled address of the page — the from / to of each message, the listed account itself included — to its public label (AddressLabel: exchange, wallet service, bridge, project, scam …, with its source and dates), keyed by the address exactly as it appears in from / to, one entry per address. An address without a label is absent, and the field is absent when no address of the page has one — a transaction list needs no second call for its labels. The labels are read for each response, so a page served from apiton's cache carries today's labels too; when they cannot be read the page comes without them. Labels come from openly licensed datasets (today ton-labels by TON Foundation, MIT): a label is the dataset's statement, not apiton's own finding — show its source with it.

Errors (Connect JSON envelope {"code":…,"message":…})

Code	When
`invalid_argument` (400)	the address cannot be parsed
`aborted` (409)	the archive or a liteserver read failed — retry

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Bodyapplication/json

Examples

SuccessWallet (live, 2026-10-19)A labelled account: labels (live, 2026-11-06)

{
    "result": [
        {
            "block": {
                "seqno": 45931794,
                "shard": "10376293541461622784"
            },
            "fee": 0.00004602,
            "in": {
                "amount": 0.5,
                "from": "UQBgrjebZvU85NVXjMncFTV5fqkLHoX9jlmTcncwsbqgRhDd",
                "symbol": "TON",
                "time": "2024-09-28T14:26:02Z",
                "to": "UQCD39VS5jcptHL8vMjEXrzGaRcCVYto7HUn4bpAOg8xqEBI"
            },
            "lt": "49517589000001",
            "success": true,
            "time": "2024-09-28T14:26:25Z",
            "tx": "256d08a1bb4ce9f26eb88144bb3559a1b295466e1d2a208b6be076909ce85d8c"
        },
        {
            "block": {
                "seqno": 45903076,
                "shard": "10376293541461622784"
            },
            "fee": 0.000002016,
            "in": {
                "amount": 6228,
                "body": {
                    "amount": "6228000000000",
                    "forward_payload": {
                        "is_right": false,
                        "value": {}
                    },
                    "query_id": 0,
                    "sender": "0:df2a24f4ca6abf29b1dd259949c91f766059624f8f667d44427c14d1d535f298"
                },
                "details": {
                    "decimals": "9",
                    "image": "https://cdn.dogs.dev/dogs.png",
                    "master_address": "UQCvxJy4eG8hyHBFsZ7eePxrRsUQSFE_jpptRAYBmcG_DLxX",
                    "name": "Dogs",
                    "symbol": "DOGS",
                    "uri": "https://cdn.dogs.dev/dogs.json"
                },
                "from": "UQCM19onN2dEioXydsBTBIkohrL8GbM1OZojgtDLYwYmNJec",
                "op_code": 1935855772,
                "operation": "JettonNotify",
                "symbol": "DOGS",
                "time": "2024-09-26T23:50:32Z",
                "to": "UQCD39VS5jcptHL8vMjEXrzGaRcCVYto7HUn4bpAOg8xqEBI"
            },
            "lt": "49483518000003",
            "time": "2024-09-26T23:50:32Z",
            "tx": "e8f5bf43d3bd89e2d26f063f16ffc1855980b095ee8efb5d5764f7a8d794aabb"
        }
    ]
}

🔴500Server Error