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