Get transactions

Returns transactions matching the specified filters. Filter by block coordinates, masterchain sequence number, account address, transaction hash, logical time, or time range. Each transaction includes inbound message, outbound messages, fees, and execution phases.

GET /api/v3/transactions

Get transactions

cURL

curl --request GET \
  --url https://toncenter.com/api/v3/transactions

200

{
  "address_book": {},
  "transactions": [
    {
      "account": "<string>",
      "account_state_after": {
        "account_status": "<string>",
        "balance": "<string>",
        "code_boc": "<string>",
        "code_hash": "<string>",
        "data_boc": "<string>",
        "data_hash": "<string>",
        "extra_currencies": {},
        "frozen_hash": "<string>",
        "hash": "<string>"
      },
      "account_state_before": {
        "account_status": "<string>",
        "balance": "<string>",
        "code_boc": "<string>",
        "code_hash": "<string>",
        "data_boc": "<string>",
        "data_hash": "<string>",
        "extra_currencies": {},
        "frozen_hash": "<string>",
        "hash": "<string>"
      },
      "block_ref": {
        "seqno": 123,
        "shard": "0",
        "workchain": 123
      },
      "description": {
        "aborted": true,
        "action": {
          "action_list_hash": "<string>",
          "msgs_created": 123,
          "no_funds": true,
          "result_arg": 123,
          "result_code": 123,
          "skipped_actions": 123,
          "spec_actions": 123,
          "status_change": "<string>",
          "success": true,
          "tot_actions": 123,
          "tot_msg_size": {
            "bits": "0",
            "cells": "0"
          },
          "total_action_fees": "0",
          "total_fwd_fees": "0",
          "valid": true
        },
        "bounce": {
          "fwd_fees": "0",
          "msg_fees": "0",
          "msg_size": {
            "bits": "0",
            "cells": "0"
          },
          "req_fwd_fees": "0",
          "type": "<string>"
        },
        "compute_ph": {
          "account_activated": true,
          "exit_arg": 123,
          "exit_code": 123,
          "gas_credit": "0",
          "gas_fees": "0",
          "gas_limit": "0",
          "gas_used": "0",
          "mode": 123,
          "msg_state_used": true,
          "reason": "<string>",
          "skipped": true,
          "success": true,
          "vm_final_state_hash": "<string>",
          "vm_init_state_hash": "<string>",
          "vm_steps": 123
        },
        "credit_first": true,
        "credit_ph": {
          "credit": "0",
          "credit_extra_currencies": {},
          "due_fees_collected": "0"
        },
        "destroyed": true,
        "installed": true,
        "is_tock": true,
        "split_info": {
          "acc_split_depth": 123,
          "cur_shard_pfx_len": 123,
          "sibling_addr": "<string>",
          "this_addr": "<string>"
        },
        "storage_ph": {
          "status_change": "<string>",
          "storage_fees_collected": "0",
          "storage_fees_due": "0"
        },
        "type": "<string>"
      },
      "emulated": true,
      "end_status": "<string>",
      "hash": "<string>",
      "in_msg": {
        "bounce": true,
        "bounced": true,
        "created_at": "0",
        "created_lt": "0",
        "decoded_opcode": "<string>",
        "destination": "<string>",
        "extra_flags": "<string>",
        "fwd_fee": "0",
        "hash": "<string>",
        "hash_norm": "<string>",
        "ihr_disabled": true,
        "ihr_fee": "0",
        "import_fee": "0",
        "in_msg_tx_hash": "<string>",
        "init_state": {
          "body": "<string>",
          "decoded": {},
          "hash": "<string>"
        },
        "message_content": {
          "body": "<string>",
          "decoded": {},
          "hash": "<string>"
        },
        "opcode": 123,
        "out_msg_tx_hash": "<string>",
        "source": "<string>",
        "value": "0",
        "value_extra_currencies": {}
      },
      "lt": "0",
      "mc_block_seqno": 123,
      "now": 123,
      "orig_status": "<string>",
      "out_msgs": [
        {
          "bounce": true,
          "bounced": true,
          "created_at": "0",
          "created_lt": "0",
          "decoded_opcode": "<string>",
          "destination": "<string>",
          "extra_flags": "<string>",
          "fwd_fee": "0",
          "hash": "<string>",
          "hash_norm": "<string>",
          "ihr_disabled": true,
          "ihr_fee": "0",
          "import_fee": "0",
          "in_msg_tx_hash": "<string>",
          "init_state": {
            "body": "<string>",
            "decoded": {},
            "hash": "<string>"
          },
          "message_content": {
            "body": "<string>",
            "decoded": {},
            "hash": "<string>"
          },
          "opcode": 123,
          "out_msg_tx_hash": "<string>",
          "source": "<string>",
          "value": "0",
          "value_extra_currencies": {}
        }
      ],
      "prev_trans_hash": "<string>",
      "prev_trans_lt": "0",
      "total_fees": "0",
      "total_fees_extra_currencies": {},
      "trace_external_hash": "<string>",
      "trace_id": "<string>"
    }
  ]
}

Query Parameters

workchain · integer<int32>

Block workchain.

shard · string

Block shard id. Must be sent with workchain. Example: 8000000000000000.

seqno · integer<int32>

Block block seqno. Must be sent with workchain and shard.

mc_seqno · integer<int32>

Masterchain block seqno.

account · string[]

List of account addresses to get transactions. Can be sent in hex, base64 or base64url form.

exclude_account · string[]

Exclude transactions on specified account addresses.

hash · string

Transaction hash.

lt · integer<int64>

Transaction lt.

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 transactions with address book.

Response wrapper containing transactions with address book.

address_book · object

Address book mapping raw addresses to user-friendly forms for all addresses referenced in the response.

Show child attributes

transactions · object[]

Array of transactions matching the query filters.

Show child attributes