TONTONDocs
TON CenterV3Actions and traces

applications/api/toncenter/v3/actions-and-traces/get-actions

GET
/api/v3/actions

Query Parameters

account?string

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

tx_hash?array<string>

Find actions by transaction hash.

msg_hash?array<string>

Find actions by message hash.

action_id?array<string>

Find actions by the action_id.

trace_id?array<string>

Find actions by the trace_id.

mc_seqno?integer

Query actions of traces which was completed in masterchain block with given seqno

Formatint32
start_utime?integer

Query actions for traces with trace_end_utime >= start_utime.

Formatint32
Range0 <= value
end_utime?integer

Query actions for traces with trace_end_utime <= end_utime.

Formatint32
Range0 <= value
start_lt?integer

Query actions for traces with trace_end_lt >= start_lt.

Formatint64
Range0 <= value
end_lt?integer

Query actions for traces with trace_end_lt <= end_lt.

Formatint64
Range0 <= value
action_type?array<>

Include action types.

exclude_action_type?array<>

Exclude action types.

supported_action_types?array<string>

Supported action types

include_accounts?boolean

Include accounts array for each action in response.

Defaultfalse
include_transactions?boolean

Include transactions_full array with detailed transaction data for each action in response.

Defaultfalse
limit?integer

Limit number of queried rows. Use with offset to batch read.

Default10
Formatint32
Range1 <= value <= 1000
offset?integer

Skip first N rows. Use with limit to batch read.

Default0
Formatint32
Range0 <= value
sort?string

Sort actions by lt.

Default"desc"
Value in"asc" | "desc"

Response Body

application/json

application/json

curl -X GET "https://example.com/api/v3/actions"
{
  "actions": [
    {
      "accounts": [
        "string"
      ],
      "action_id": "string",
      "details": null,
      "end_lt": "0",
      "end_utime": 0,
      "start_lt": "0",
      "start_utime": 0,
      "success": true,
      "trace_end_lt": "0",
      "trace_end_utime": 0,
      "trace_external_hash": "string",
      "trace_external_hash_norm": "string",
      "trace_id": "string",
      "trace_mc_seqno_end": 0,
      "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": {
              "property1": "string",
              "property2": "string"
            },
            "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": {
              "property1": "string",
              "property2": "string"
            },
            "frozen_hash": "string",
            "hash": "string"
          },
          "block_ref": {
            "seqno": 0,
            "shard": "0",
            "workchain": 0
          },
          "description": {
            "aborted": true,
            "action": {
              "action_list_hash": "string",
              "msgs_created": 0,
              "no_funds": true,
              "result_arg": 0,
              "result_code": 0,
              "skipped_actions": 0,
              "spec_actions": 0,
              "status_change": "string",
              "success": true,
              "tot_actions": 0,
              "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": 0,
              "exit_code": 0,
              "gas_credit": "0",
              "gas_fees": "0",
              "gas_limit": "0",
              "gas_used": "0",
              "mode": 0,
              "msg_state_used": true,
              "reason": "string",
              "skipped": true,
              "success": true,
              "vm_final_state_hash": "string",
              "vm_init_state_hash": "string",
              "vm_steps": 0
            },
            "credit_first": true,
            "credit_ph": {
              "credit": "0",
              "credit_extra_currencies": {
                "property1": "string",
                "property2": "string"
              },
              "due_fees_collected": "0"
            },
            "destroyed": true,
            "installed": true,
            "is_tock": true,
            "split_info": {
              "acc_split_depth": 0,
              "cur_shard_pfx_len": 0,
              "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": 0,
            "out_msg_tx_hash": "string",
            "source": "string",
            "value": "0",
            "value_extra_currencies": {
              "property1": "string",
              "property2": "string"
            }
          },
          "lt": "0",
          "mc_block_seqno": 0,
          "now": 0,
          "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": 0,
              "out_msg_tx_hash": "string",
              "source": "string",
              "value": "0",
              "value_extra_currencies": {
                "property1": "string",
                "property2": "string"
              }
            }
          ],
          "prev_trans_hash": "string",
          "prev_trans_lt": "0",
          "total_fees": "0",
          "total_fees_extra_currencies": {
            "property1": "string",
            "property2": "string"
          },
          "trace_external_hash": "string",
          "trace_id": "string"
        }
      ],
      "type": "string"
    }
  ],
  "address_book": {
    "property1": {
      "domain": "string",
      "interfaces": [
        "string"
      ],
      "user_friendly": "string"
    },
    "property2": {
      "domain": "string",
      "interfaces": [
        "string"
      ],
      "user_friendly": "string"
    }
  },
  "metadata": {
    "property1": {
      "is_indexed": true,
      "token_info": [
        {
          "description": "string",
          "extra": {},
          "image": "string",
          "name": "string",
          "nft_index": "string",
          "symbol": "string",
          "type": "string",
          "valid": true
        }
      ]
    },
    "property2": {
      "is_indexed": true,
      "token_info": [
        {
          "description": "string",
          "extra": {},
          "image": "string",
          "name": "string",
          "nft_index": "string",
          "symbol": "string",
          "type": "string",
          "valid": true
        }
      ]
    }
  }
}
{
  "code": 0,
  "error": "string"
}

Last updated on

applications/api/toncenter/v3/accounts/metadata

applications/api/toncenter/v3/actions-and-traces/get-pending-actions