Get Account Transactions

Retrieves on-chain committed transactions from an account.

This method will use 150 Compute Units.

Get account transactions

Retrieves on-chain committed transactions from an account. If the start version is too far in the past, a 410 will be returned.

If no start version is given, it will start at version 0.

To retrieve a pending transaction, use /transactions/by_hash.

GEThttps://mainnet.aptos.validationcloud.io/v1/<YOUR_API_KEY_HERE>/v1/accounts/{address}/transactions

Path parameters

address*Address (string (hex))

A hex encoded 32 byte Aptos account address.

This is represented in a string as a 64 character hex string, sometimes shortened by stripping leading 0s, and adding a 0x.

For example, address 0x0000000000000000000000000000000000000000000000000000000000000001 is represented as 0x1.

Example: "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 "

Query parameters

startU64 (string (uint64))

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such as JavaScript that do not parse u64s in JSON natively.

Example: "32425224034"

limitinteger (uint16)

Max number of transactions to retrieve.

If not provided, defaults to default page size

Response

Headers

X-APTOS-CHAIN-ID*integer (uint8)

X-APTOS-LEDGER-VERSION*integer (uint64)

X-APTOS-LEDGER-OLDEST-VERSION*integer (uint64)

X-APTOS-LEDGER-TIMESTAMPUSEC*integer (uint64)

X-APTOS-EPOCH*integer (uint64)

X-APTOS-BLOCK-HEIGHT*integer (uint64)

X-APTOS-OLDEST-BLOCK-HEIGHT*integer (uint64)

X-APTOS-CURSORstring

Body

array of Transaction (object)

Request

const response = await fetch('https://mainnet.aptos.validationcloud.io/v1/<YOUR_API_KEY_HERE>/v1/accounts/{address}/transactions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "type": "pending_transaction",
    "hash": "text",
    "sender": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 ",
    "sequence_number": "32425224034",
    "max_gas_amount": "32425224034",
    "gas_unit_price": "32425224034",
    "expiration_timestamp_secs": "32425224034",
    "payload": {
      "type": "entry_function_payload",
      "function": "0x1::aptos_coin::transfer",
      "type_arguments": [
        "text"
      ],
      "arguments": []
    },
    "signature": {
      "type": "ed25519_signature",
      "public_key": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 ",
      "signature": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 "
    }
  }
]