/v1/transactions - Aptos

Example code for the /v1/transactions json-rpc method. Сomplete guide on how to use /v1/transactions json-rpc in GetBlock.io Web3 documentation.

This endpoint gets the list of recent transactions from the Aptos blockchain.

Supported Network

• Mainnet

Parameter

Parameter	Type	In	Required	Description
start	Integer	Query	No	Starting transaction version for pagination.
limit	Integer	Query	No	Number of transactions to return. Default: 25. Maximum: 100.

Request

Base URL

https://go.getblock.io/<ACCESS_TOKEN>

Example(cURL)

curl --location 'https://go.getblock.io/<ACCESS_TOKEN>/v1/transactions?limit=1'

Response Example

[
    {
        "version": "3556744764",
        "hash": "0x1cd28f386d48edfaf30c822117bd0b971e349c59f5fdd08f284558b33ac1715f",
        "state_change_hash": "0xafb6e14fe47d850fd0a7395bcfb997ffacf4715e0f895cc162c218e4a7564bc6",
        "event_root_hash": "0x414343554d554c41544f525f504c414345484f4c4445525f4841534800000000",
        "state_checkpoint_hash": "0xe8daf9e9f3986dc69e0247b5638af4f55a6e5912da8a2c71e1fa537009a59964",
        "gas_used": "0",
        "success": true,
        "vm_status": "Executed successfully",
        "accumulator_root_hash": "0x6a006a1a2d4d22b7fdf4ca27a31aac610c3911429d8e5f925e31016738b225e2",
        "changes": [],
        "timestamp": "1760341338522220",
        "block_end_info": {
            "block_gas_limit_reached": false,
            "block_output_limit_reached": false,
            "block_effective_block_gas_units": 71,
            "block_approx_output_size": 7846
        },
        "type": "block_epilogue_transaction"
    }
]

Response Parameter Definition

Field	Type	Description
version	String	Global transaction version (unique ID in Aptos ledger).
hash	String	Transaction hash.
state_change_hash	String	Hash of all state changes caused by this transaction.
event_root_hash	String	Merkle root hash of all events emitted.
state_checkpoint_hash	String	Hash of the state checkpoint for this transaction.
gas_used	String	Amount of gas consumed (0 here, since it’s a system txn).
success	Boolean	Whether the transaction executed successfully.
vm_status	String	VM execution result.
accumulator_root_hash	String	Ledger’s global accumulator root after applying this transaction.
changes	Array	State changes caused (empty here).
timestamp	String	Unix timestamp in microseconds.
block_end_info	Object	Metadata about block execution limits.
block_end_info.block_gas_limit_reached	Boolean	Whether the block’s gas limit was hit.
block_end_info.block_output_limit_reached	Boolean	Whether block output size was exceeded.
block_end_info.block_effective_block_gas_units	Interger	Total effective gas used in the block.
block_end_info.block_approx_output_size	Integer	Approximate output size of the block in bytes.
type	String	Transaction type → here it’s block_epilogue_transaction (special system txn marking block end).

Use Cases

This method is used for:

• Display a feed of recent blockchain activity.

• Monitor all user-submitted transactions in real time.

• Build analytics dashboards for transaction patterns.

Code Example

Node(Axios)

const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://go.getblock.io/<ACCESS_TOKEN>/v1/transactions?limit=1',
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Python(Request)

import requests

url = "https://go.getblock.io/<ACCESS_TOKEN>/v1/transactions?limit=1"

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

print(response.text)

Error handling

Status Code	Error Message	Cause
403	Forbidden	Missing or invalid ACCESS_TOKEN.
500	Internal server error	Node or network issue; retry later.

Integration with Web3

By integrating /v1/transactions, developers can:

• Stream blockchain activity into wallets and dApps.

• Enable dashboards showing the latest transfers, mints, or contract calls.

• Support DeFi/NFT protocols by tracking relevant transactions.

• Provide analytics & insights on transaction frequency, volume, and patterns.