Query Parameters

account

string

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

tx_hash

array

Find actions by transaction hash.

msg_hash

array

Find actions by message hash.

action_id

array

Find actions by the action_id.

trace_id

array

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.

end_utime

integer

Query actions for traces with trace_end_utime <= end_utime.

start_lt

integer

Query actions for traces with trace_end_lt >= start_lt.

end_lt

integer

Query actions for traces with trace_end_lt <= end_lt.

action_type

array

Include action types.

exclude_action_type

array

Exclude action types.

limit

integer

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

offset

integer

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

sort

string

Sort actions by lt.

Returns

actions

array

List of actions executed within a transaction trace, such as token transfers or contract calls.

action_id

string | null

Unique identifier for the specific action within the trace.

trace_id

string | null

Unique identifier representing the entire trace of actions.

start_lt

string | null

Logical time (LT) marking the beginning of the action.

end_lt

string | null

Logical time (LT) marking the end of the action execution.

start_utime

integer | null

Unix timestamp when the action began execution.

end_utime

integer | null

Unix timestamp marking when the action finished executing.

trace_end_lt

string | null

Logical time (LT) at which the entire trace concludes.

trace_end_utime

integer | null

Unix timestamp when the trace ends.

trace_mc_seqno_end

integer | null

Masterchain sequence number at the end of the trace.

transactions

array | null

(Optional) List of transaction hashes related to the action.

success

boolean | null

Indicates whether the action executed successfully.

type

string | null

Type of action (e.g., jetton_transfer, ton_transfer, nft_transfer, call_contract).

trace_external_hash

string | null

External hash associated with the trace, used for trace verification or linking.

trace_external_hash_norm

string | null

Normalized external hash for the trace.

finality

string

Finality status of the trace (e.g. finalized, provisional).

details

object | null

(Optional) Detailed payload of the action, depending on its type.

asset

string

(Optional) Jetton asset address being transferred.

sender

string

(Optional) Address of the sender account.

receiver

string

(Optional) Address of the receiver account.

sender_jetton_wallet

string | null

(Optional) Jetton wallet address of the sender.

receiver_jetton_wallet

string | null

(Optional) Jetton wallet address of the receiver.

amount

string

(Optional) Amount of jettons transferred, as a string.

comment

string | null

(Optional) Optional user comment included in the transfer.

is_encrypted_comment

boolean | null

(Optional) Whether the comment is encrypted.

query_id

string

(Optional) Query ID used for tracking or correlation.

response_destination

string | null

(Optional) Address to send the response to.

custom_payload

string | null

(Optional) Optional custom payload for contract logic.

forward_payload

string | null

(Optional) Optional payload forwarded to receiver.

forward_amount

string | null

Amount of TON to forward with the transfer; may be null on some NFT transfers.

source

string

(Optional) Address of the TON transfer sender.

destination

string

(Optional) Address of the TON transfer recipient.

value

string

(Optional) Amount of TON transferred (in nanotons).

value_extra_currencies

object

(Optional) Map of extra currency values (if used).

encrypted

boolean

(Optional) Indicates if the payload or comment was encrypted.

nft_collection

string | null

(Optional) Address of the NFT collection.

nft_item

string

(Optional) Address of the specific NFT item.

nft_item_index

string

(Optional) Index or ID of the NFT item within the collection.

old_owner

string

(Optional) Previous owner address of the NFT.

new_owner

string

(Optional) New owner address of the NFT.

is_purchase

boolean

(Optional) True if the NFT transfer was a purchase event.

marketplace

string | null

(Optional) Marketplace identifier for NFT sale transfers.

real_old_owner

string | null

(Optional) Actual previous owner when a marketplace intermediates the transfer.

marketplace_address

string | null

(Optional) Marketplace contract address.

payout_amount

string | null

(Optional) Payout amount for marketplace NFT sales.

payout_address

string | null

(Optional) Recipient address for marketplace payout.

payout_comment

string | null

(Optional) Comment attached to the marketplace payout.

payout_comment_encrypted

boolean | null

(Optional) Whether the payout comment is encrypted.

payout_comment_encoded

string | null

(Optional) Encoded payout comment payload.

royalty_amount

string | null

(Optional) Royalty amount for NFT marketplace sales.

royalty_address

string | null

(Optional) Royalty recipient address.

opcode

string

(Optional) Opcode or method identifier of the contract call.

extra_currencies

object

(Optional) Optional extra currencies sent with the call.

address_book

object

(Optional) Mapping of addresses to user-friendly formats and domains, enhancing readability.

address

object | null

(Optional) The address object which contains the following fields:

user_friendly

string | null

Base64URL-encoded, user-friendly version of the address.

domain

string | null

Optional domain associated with the address (e.g., from DNS).

metadata

object

(Optional) Optional metadata about addresses, including indexing and associated token info.

address

object | null

(Optional) Each key represents an address mapped to its metadata.

is_indexed

boolean | null

Indicates whether the address is indexed in the backend system.

token_info

array | null

(Optional) Array of tokens associated with the address, including branding and metadata.

type

string | null

Type of token (e.g., fungible, NFT).

name

string | null

Name of the token.

symbol

string | null

Ticker symbol of the token (e.g., TON, USDT).

description

string | null

Human-readable description of the token.

image

string | null

URL to the token's image or logo.

extra

object | null

(Optional) Additional metadata for the token, such as image sizes, decimal precision, external links, and marketplaces.

_image_big

string | null

URL to a high-resolution image of the token.

_image_medium

string | null

URL to a medium-resolution image of the token.

_image_small

string | null

URL to a small or thumbnail-sized image of the token.

decimals

string | null

The number of decimal places used to represent token values.

external_url

string | null

External link to more information about the token (e.g., project website).

marketplace

string | null

URL or identifier of the marketplace where the token can be traded.

uri

string | null

Token metadata URI (e.g., NFT metadata file location).

Request

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/api/v3/actions?account=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2' \
2
--header 'accept: application/json'

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/api/v3/actions?account=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2' \
2
--header 'accept: application/json'

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3

4
const requestOptions = {
5
    method: "GET",
6
    headers: myHeaders,
7
    redirect: "follow"
8
};
9

10
fetch("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/actions?account=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2", requestOptions)

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3

4
const requestOptions = {
5
    method: "GET",
6
    headers: myHeaders,
7
    redirect: "follow"
8
};
9

10
fetch("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/actions?account=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2", requestOptions)

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/api/v3/actions?account=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
4

5
payload = {}
6
headers = {
7
    'accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/api/v3/actions?account=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
4

5
payload = {}
6
headers = {
7
    'accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/actions?account=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["accept"] = "application/json"
9

10
response = http.request(request)

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/actions?account=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["accept"] = "application/json"
9

10
response = http.request(request)

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free