actions

Get Actions

Get actions by specified filter.

get/api/v3/actions

Request

  • Base URL: https://toncenter.com (the document declares no server; this is the origin it was published from)
  • URL: https://toncenter.com/api/v3/actions
  • Auth: one of:
    • API key in header X-Api-Key
    • API key in query parameter api_key

Query parameters

accountstring

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

tx_hashstring[]

Find actions by transaction hash.

msg_hashstring[]

Find actions by message hash.

action_idstring[]

Find actions by the action_id.

trace_idstring[]

Find actions by the trace_id.

mc_seqnointeger

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

start_utimeinteger

Query actions for traces with trace_end_utime >= start_utime.

end_utimeinteger

Query actions for traces with trace_end_utime <= end_utime.

start_ltinteger

Query actions for traces with trace_end_lt >= start_lt.

end_ltinteger

Query actions for traces with trace_end_lt <= end_lt.

action_typestring[]

Include action types.

exclude_action_typestring[]

Exclude action types.

supported_action_typesstring[]

Supported action types

include_accountsboolean

Include accounts array for each action in response.

include_transactionsboolean

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

limitinteger

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

offsetinteger

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

cursorstring

Continue after the page that returned this next_cursor. Send the same filters and sort; not combined with offset.

sort'asc' | 'desc'

Sort actions by lt.

Response

OK

address_bookAddressBook
metadataMetadata
next_cursorstring

Example response

{
  "actions": [
    {
      "end_lt": "0",
      "start_lt": "0",
      "trace_end_lt": "0",
      "transactions_full": [
        {
          "block_ref": {
            "shard": "0"
          },
          "description": {
            "action": {
              "tot_msg_size": {
                "bits": "0",
                "cells": "0"
              },
              "total_action_fees": "0",
              "total_fwd_fees": "0"
            },
            "bounce": {
              "fwd_fees": "0",
              "msg_fees": "0",
              "msg_size": {
                "bits": "0",
                "cells": "0"
              },
              "req_fwd_fees": "0"
            },
            "compute_ph": {
              "gas_credit": "0",
              "gas_fees": "0",
              "gas_limit": "0",
              "gas_used": "0"
            },
            "credit_ph": {
              "credit": "0",
              "due_fees_collected": "0"
            },
            "storage_ph": {
              "storage_fees_collected": "0",
              "storage_fees_due": "0"
            }
          },
          "in_msg": {
            "created_at": "0",
            "created_lt": "0",
            "fwd_fee": "0",
            "ihr_fee": "0",
            "import_fee": "0",
            "value": "0"
          },
          "lt": "0",
          "out_msgs": [
            {
              "created_at": "0",
              "created_lt": "0",
              "fwd_fee": "0",
              "ihr_fee": "0",
              "import_fee": "0",
              "value": "0"
            }
          ],
          "prev_trans_lt": "0",
          "total_fees": "0"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.