Skip to main content
GET
/
api
/
v3
/
actions
List actions by filters (tx, msg, trace)
curl --request GET \
  --url https://toncenter.com/api/v3/actions
{
  "actions": [
    {
      "accounts": [
        "<string>"
      ],
      "action_id": "<string>",
      "details": "<any>",
      "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>"
      ],
      "type": "<string>"
    }
  ],
  "address_book": {},
  "metadata": {}
}

Query Parameters

​
account
string

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

​
tx_hash
string[]

Find actions by transaction hash.

​
msg_hash
string[]

Find actions by message hash.

​
action_id
string[]

Find actions by the action_id.

​
trace_id
string[]

Find actions by the trace_id.

​
mc_seqno
integer

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

​
start_utime
integer

Query actions for traces with trace_end_utime >= start_utime.

Required range: x >= 0
​
end_utime
integer

Query actions for traces with trace_end_utime <= end_utime.

Required range: x >= 0
​
start_lt
integer

Query actions for traces with trace_end_lt >= start_lt.

Required range: x >= 0
​
end_lt
integer

Query actions for traces with trace_end_lt <= end_lt.

Required range: x >= 0
​
action_type
enum<string>[]

Include action types.

​
exclude_action_type
enum<string>[]

Exclude action types.

​
supported_action_types
string[]

Supported action types

​
limit
integer
default:10

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

Required range: 1 <= x <= 1000
​
offset
integer
default:0

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

Required range: x >= 0
​
sort
enum<string>
default:desc

Sort actions by lt.

Available options:
asc,
desc

Response

OK

​
actions
object[]
​
address_book
object
​
metadata
object
⌘I