Get Traces
curl --request GET \
--url https://toncenter.com/api/v3/traces{
"address_book": {},
"metadata": {},
"traces": [
{
"actions": [
{
"accounts": [
"<string>"
],
"action_id": "<string>",
"details": "<unknown>",
"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>"
],
"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": {},
"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": {},
"frozen_hash": "<string>",
"hash": "<string>"
},
"block_ref": {
"seqno": 123,
"shard": "0",
"workchain": 123
},
"description": {
"aborted": true,
"action": {
"action_list_hash": "<string>",
"msgs_created": 123,
"no_funds": true,
"result_arg": 123,
"result_code": 123,
"skipped_actions": 123,
"spec_actions": 123,
"status_change": "<string>",
"success": true,
"tot_actions": 123,
"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": 123,
"exit_code": 123,
"gas_credit": "0",
"gas_fees": "0",
"gas_limit": "0",
"gas_used": "0",
"mode": 123,
"msg_state_used": true,
"reason": "<string>",
"skipped": true,
"success": true,
"vm_final_state_hash": "<string>",
"vm_init_state_hash": "<string>",
"vm_steps": 123
},
"credit_first": true,
"credit_ph": {
"credit": "0",
"credit_extra_currencies": {},
"due_fees_collected": "0"
},
"destroyed": true,
"installed": true,
"is_tock": true,
"split_info": {
"acc_split_depth": 123,
"cur_shard_pfx_len": 123,
"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": 123,
"out_msg_tx_hash": "<string>",
"source": "<string>",
"value": "0",
"value_extra_currencies": {}
},
"lt": "0",
"mc_block_seqno": 123,
"now": 123,
"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": 123,
"out_msg_tx_hash": "<string>",
"source": "<string>",
"value": "0",
"value_extra_currencies": {}
}
],
"prev_trans_hash": "<string>",
"prev_trans_lt": "0",
"total_fees": "0",
"total_fees_extra_currencies": {},
"trace_external_hash": "<string>",
"trace_id": "<string>"
}
],
"type": "<string>"
}
],
"end_lt": "0",
"end_utime": 123,
"external_hash": "<string>",
"is_incomplete": true,
"mc_seqno_end": "<string>",
"mc_seqno_start": "<string>",
"start_lt": "0",
"start_utime": 123,
"trace": {
"children": "<array>",
"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": 123,
"out_msg_tx_hash": "<string>",
"source": "<string>",
"value": "0",
"value_extra_currencies": {}
},
"in_msg_hash": "<string>",
"transaction": {
"account": "<string>",
"account_state_after": {
"account_status": "<string>",
"balance": "<string>",
"code_boc": "<string>",
"code_hash": "<string>",
"data_boc": "<string>",
"data_hash": "<string>",
"extra_currencies": {},
"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": {},
"frozen_hash": "<string>",
"hash": "<string>"
},
"block_ref": {
"seqno": 123,
"shard": "0",
"workchain": 123
},
"description": {
"aborted": true,
"action": {
"action_list_hash": "<string>",
"msgs_created": 123,
"no_funds": true,
"result_arg": 123,
"result_code": 123,
"skipped_actions": 123,
"spec_actions": 123,
"status_change": "<string>",
"success": true,
"tot_actions": 123,
"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": 123,
"exit_code": 123,
"gas_credit": "0",
"gas_fees": "0",
"gas_limit": "0",
"gas_used": "0",
"mode": 123,
"msg_state_used": true,
"reason": "<string>",
"skipped": true,
"success": true,
"vm_final_state_hash": "<string>",
"vm_init_state_hash": "<string>",
"vm_steps": 123
},
"credit_first": true,
"credit_ph": {
"credit": "0",
"credit_extra_currencies": {},
"due_fees_collected": "0"
},
"destroyed": true,
"installed": true,
"is_tock": true,
"split_info": {
"acc_split_depth": 123,
"cur_shard_pfx_len": 123,
"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": 123,
"out_msg_tx_hash": "<string>",
"source": "<string>",
"value": "0",
"value_extra_currencies": {}
},
"lt": "0",
"mc_block_seqno": 123,
"now": 123,
"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": 123,
"out_msg_tx_hash": "<string>",
"source": "<string>",
"value": "0",
"value_extra_currencies": {}
}
],
"prev_trans_hash": "<string>",
"prev_trans_lt": "0",
"total_fees": "0",
"total_fees_extra_currencies": {},
"trace_external_hash": "<string>",
"trace_id": "<string>"
},
"tx_hash": "<string>"
},
"trace_id": "<string>",
"trace_info": {
"classification_state": "<string>",
"messages": 123,
"pending_messages": 123,
"trace_state": "<string>",
"transactions": 123
},
"transactions": {},
"transactions_order": [
"<string>"
],
"warning": "<string>"
}
]
}{
"code": 123,
"error": "<string>"
}Get traces by specified filter.
GET
/
api
/
v3
/
traces
Get Traces
curl --request GET \
--url https://toncenter.com/api/v3/traces{
"address_book": {},
"metadata": {},
"traces": [
{
"actions": [
{
"accounts": [
"<string>"
],
"action_id": "<string>",
"details": "<unknown>",
"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>"
],
"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": {},
"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": {},
"frozen_hash": "<string>",
"hash": "<string>"
},
"block_ref": {
"seqno": 123,
"shard": "0",
"workchain": 123
},
"description": {
"aborted": true,
"action": {
"action_list_hash": "<string>",
"msgs_created": 123,
"no_funds": true,
"result_arg": 123,
"result_code": 123,
"skipped_actions": 123,
"spec_actions": 123,
"status_change": "<string>",
"success": true,
"tot_actions": 123,
"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": 123,
"exit_code": 123,
"gas_credit": "0",
"gas_fees": "0",
"gas_limit": "0",
"gas_used": "0",
"mode": 123,
"msg_state_used": true,
"reason": "<string>",
"skipped": true,
"success": true,
"vm_final_state_hash": "<string>",
"vm_init_state_hash": "<string>",
"vm_steps": 123
},
"credit_first": true,
"credit_ph": {
"credit": "0",
"credit_extra_currencies": {},
"due_fees_collected": "0"
},
"destroyed": true,
"installed": true,
"is_tock": true,
"split_info": {
"acc_split_depth": 123,
"cur_shard_pfx_len": 123,
"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": 123,
"out_msg_tx_hash": "<string>",
"source": "<string>",
"value": "0",
"value_extra_currencies": {}
},
"lt": "0",
"mc_block_seqno": 123,
"now": 123,
"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": 123,
"out_msg_tx_hash": "<string>",
"source": "<string>",
"value": "0",
"value_extra_currencies": {}
}
],
"prev_trans_hash": "<string>",
"prev_trans_lt": "0",
"total_fees": "0",
"total_fees_extra_currencies": {},
"trace_external_hash": "<string>",
"trace_id": "<string>"
}
],
"type": "<string>"
}
],
"end_lt": "0",
"end_utime": 123,
"external_hash": "<string>",
"is_incomplete": true,
"mc_seqno_end": "<string>",
"mc_seqno_start": "<string>",
"start_lt": "0",
"start_utime": 123,
"trace": {
"children": "<array>",
"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": 123,
"out_msg_tx_hash": "<string>",
"source": "<string>",
"value": "0",
"value_extra_currencies": {}
},
"in_msg_hash": "<string>",
"transaction": {
"account": "<string>",
"account_state_after": {
"account_status": "<string>",
"balance": "<string>",
"code_boc": "<string>",
"code_hash": "<string>",
"data_boc": "<string>",
"data_hash": "<string>",
"extra_currencies": {},
"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": {},
"frozen_hash": "<string>",
"hash": "<string>"
},
"block_ref": {
"seqno": 123,
"shard": "0",
"workchain": 123
},
"description": {
"aborted": true,
"action": {
"action_list_hash": "<string>",
"msgs_created": 123,
"no_funds": true,
"result_arg": 123,
"result_code": 123,
"skipped_actions": 123,
"spec_actions": 123,
"status_change": "<string>",
"success": true,
"tot_actions": 123,
"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": 123,
"exit_code": 123,
"gas_credit": "0",
"gas_fees": "0",
"gas_limit": "0",
"gas_used": "0",
"mode": 123,
"msg_state_used": true,
"reason": "<string>",
"skipped": true,
"success": true,
"vm_final_state_hash": "<string>",
"vm_init_state_hash": "<string>",
"vm_steps": 123
},
"credit_first": true,
"credit_ph": {
"credit": "0",
"credit_extra_currencies": {},
"due_fees_collected": "0"
},
"destroyed": true,
"installed": true,
"is_tock": true,
"split_info": {
"acc_split_depth": 123,
"cur_shard_pfx_len": 123,
"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": 123,
"out_msg_tx_hash": "<string>",
"source": "<string>",
"value": "0",
"value_extra_currencies": {}
},
"lt": "0",
"mc_block_seqno": 123,
"now": 123,
"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": 123,
"out_msg_tx_hash": "<string>",
"source": "<string>",
"value": "0",
"value_extra_currencies": {}
}
],
"prev_trans_hash": "<string>",
"prev_trans_lt": "0",
"total_fees": "0",
"total_fees_extra_currencies": {},
"trace_external_hash": "<string>",
"trace_id": "<string>"
},
"tx_hash": "<string>"
},
"trace_id": "<string>",
"trace_info": {
"classification_state": "<string>",
"messages": 123,
"pending_messages": 123,
"trace_state": "<string>",
"transactions": 123
},
"transactions": {},
"transactions_order": [
"<string>"
],
"warning": "<string>"
}
]
}{
"code": 123,
"error": "<string>"
}Query Parameters
List of account addresses to get transactions. Can be sent in hex, base64 or base64url form.
Find trace by trace id.
Find trace by transaction hash.
Find trace by message hash.
Query traces that was completed in masterchain block with given seqno
Query traces, which was finished after given timestamp.
Query traces, which was finished before given timestamp.
Query traces with end_lt >= start_lt.
Query traces with end_lt <= end_lt.
Include trace actions.
Supported action types
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Sort traces by lt.
Available options:
asc, desc Was this page helpful?
⌘I