# /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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.