Get Traces

Get traces by specified filter.

GET /api/v3/traces

Get Traces

cURL

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

200

{
  "address_book": {},
  "metadata": {},
  "traces": [
    {
      "actions": [
        {
          "accounts": [
            "<string>"
          ],
          "action_id": "<string>",
          "details": "<unknown>",
          "end_lt": "0",
          "end_utime": 123,
          "start_lt": "0",
          "start_utime": 123,
          "success": true,
          "trace_end_lt": "0",
          "trace_end_utime": 123,
          "trace_external_hash": "<string>",
          "trace_external_hash_norm": "<string>",
          "trace_id": "<string>",
          "trace_mc_seqno_end": 123,
          "transactions": [
            "<string>"
          ],
          "transactions_full": [
            {
              "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>"
            }
          ],
          "type": "<string>"
        }
      ],
      "end_lt": "0",
      "end_utime": 123,
      "external_hash": "<string>",
      "is_incomplete": true,
      "mc_seqno_end": "<string>",
      "mc_seqno_start": "<string>",
      "start_lt": "0",
      "start_utime": 123,
      "trace": {
        "children": "<array>",
        "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": {}
        },
        "in_msg_hash": "<string>",
        "transaction": {
          "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>"
        },
        "tx_hash": "<string>"
      },
      "trace_id": "<string>",
      "trace_info": {
        "classification_state": "<string>",
        "messages": 123,
        "pending_messages": 123,
        "trace_state": "<string>",
        "transactions": 123
      },
      "transactions": {},
      "transactions_order": [
        "<string>"
      ],
      "warning": "<string>"
    }
  ]
}

Query Parameters

account · string

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

trace_id · string[]

Find trace by trace id.

tx_hash · string[]

Find trace by transaction hash.

msg_hash · string[]

Find trace by message hash.

mc_seqno · integer<int32>

Query traces that was completed in masterchain block with given seqno

start_utime · integer<int32>

Query traces, which was finished after given timestamp.

Required range: x >= 0

end_utime · integer<int32>

Query traces, which was finished before given timestamp.

Required range: x >= 0

start_lt · integer<int64>

Query traces with end_lt >= start_lt.

Required range: x >= 0

end_lt · integer<int64>

Query traces with end_lt <= end_lt.

Required range: x >= 0

include_actions · boolean · default: false

Include trace actions.

supported_action_types · string[]

Supported action types

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 traces by lt.

Available options: asc, desc

Response

200

application/json

OK

address_book · object

Show child attributes

metadata · object

Show child attributes

traces · object[]

Show child attributes