> For the complete documentation index, see [llms.txt](https://docs.getblock.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getblock.io/api-reference/aptos-apt/apt_v1_transactions.md).

# /v1/transactions - Aptos

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**

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

**Example(cURL)**

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

## Response Example

```json
[
    {
        "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)**

```python
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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.getblock.io/api-reference/aptos-apt/apt_v1_transactions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.