> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.
# actions | TON v3
> The actions endpoint retrieves decoded, human-readable actions from TON blockchain transactions. The actions endpoint retrieves decoded.
# Actions
The `actions` endpoint retrieves decoded, human-readable actions from TON blockchain transactions. Actions represent high-level operations like Jetton transfers, NFT transfers, and TON transfers, parsed from raw transaction data.
**TON billing: full or archive by block age**
This method is billed as archive (2 RUs) when the requested block is 128 or more seqno behind the tip, and full (1 RU) otherwise. See [Request units — TON method scope](/docs/request-units#ton-method-scope).
## Parameters
* `action_id` (string, optional) — Filter by specific action ID.
* `trace_id` (string, optional) — Get actions for a specific trace.
* `tx_hash` (string, optional) — Get actions for a specific transaction hash.
* `tx_lt` (integer, optional) — Filter by transaction logical time.
* `account` (string, optional) — Filter by account address.
* `action_type` (string, optional) — Filter by action type (e.g., `JettonTransfer`, `NftItemTransfer`, `TonTransfer`).
* `start_utime` (integer, optional) — Start of time range (unix timestamp).
* `end_utime` (integer, optional) — End of time range (unix timestamp).
* `limit` (integer, optional) — Maximum number of actions to return. Default: `10`.
* `offset` (integer, optional) — Number of actions to skip for pagination. Default: `0`.
* `sort` (string, optional) — Sort order: `asc` or `desc`. Default: `desc`.
## Response
* `actions` (array) — Array of action objects containing:
* `action_id` (string) — Unique identifier for the action.
* `trace_id` (string) — Trace ID this action belongs to.
* `tx_hash` (string) — Hash of the transaction containing this action.
* `type` (string) — Type of action (e.g., `JettonTransfer`, `NftItemTransfer`, `TonTransfer`, `ContractDeploy`).
* `status` (string) — Action status (e.g., `ok`, `failed`).
* `value` (object) — Action-specific data (varies by action type).
* `start_lt` (integer) — Logical time when the action started.
* `start_utime` (integer) — Unix timestamp when the action started.
* `end_lt` (integer) — Logical time when the action ended.
* `end_utime` (integer) — Unix timestamp when the action ended.
* `address_book` (object) — Address book mapping raw addresses to user-friendly information.
## Use case
The `actions` endpoint provides a higher-level view of blockchain activity than raw transactions:
1. Building user-friendly transaction histories showing "sent 100 USDT" instead of raw message data.
2. Filtering specific action types like all Jetton transfers for an account.
3. Creating analytics dashboards for token activity.
4. Implementing notification systems for specific action types.
5. Building portfolio trackers that understand different asset movements.
Here's an example of getting Jetton transfer actions:
```shell shell theme={"system"}
curl -X GET \
'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/actions?action_type=JettonTransfer&limit=5' \
-H 'accept: application/json'
```
Actions are decoded from traces, so they provide the same completeness as traces but in a more digestible format. Use actions for user-facing features and traces for deep debugging.
## OpenAPI
````yaml openapi/ton_node_api/v3/getActions.json GET /actions
openapi: 3.0.0
info:
title: TON API
version: 3.0.0
description: API for interacting with The Open Network (TON) blockchain
servers:
- url: >-
https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3
security: []
paths:
/actions:
get:
tags:
- Actions
summary: Get Actions
description: Retrieves decoded actions from transactions
operationId: getActions
parameters:
- name: action_id
in: query
description: Action ID to filter by
schema:
type: string
- name: trace_id
in: query
description: Trace ID to get actions for
schema:
type: string
- name: tx_hash
in: query
description: Transaction hash to get actions for
schema:
type: string
default: BhLJTdV2R6Vr5c3BAOjH8nFpnMYOuPcJvRlagGSKU88=
- name: tx_lt
in: query
description: Transaction logical time
schema:
type: integer
- name: account
in: query
description: Filter by account address
schema:
type: string
- name: action_type
in: query
description: Filter by action type (e.g., JettonTransfer, NftItemTransfer)
schema:
type: string
- name: start_utime
in: query
description: Start of the time range (unix timestamp)
schema:
type: integer
- name: end_utime
in: query
description: End of the time range (unix timestamp)
schema:
type: integer
- name: limit
in: query
description: Maximum number of actions to return
schema:
type: integer
default: 10
- name: offset
in: query
description: Number of actions to skip
schema:
type: integer
default: 0
- name: sort
in: query
description: Sort order
schema:
type: string
enum:
- asc
- desc
default: desc
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
actions:
type: array
items:
type: object
properties:
action_id:
type: string
description: Unique identifier for the action
trace_id:
type: string
description: Trace ID this action belongs to
tx_hash:
type: string
description: Transaction hash
type:
type: string
description: Type of action (e.g., JettonTransfer, TonTransfer)
status:
type: string
description: Action status
value:
type: object
description: Action-specific value data
start_lt:
type: integer
description: Logical time at action start
start_utime:
type: integer
description: Unix timestamp at action start
end_lt:
type: integer
description: Logical time at action end
end_utime:
type: integer
description: Unix timestamp at action end
address_book:
type: object
description: Address book mapping addresses to user-friendly names
````