1 of 1

Get Transaction by Version

Retrieves a transaction by a given version.

This method will use 15 Compute Units.

Get Transaction by Version

Retrieves a transaction by a given version.

This method will use 15 Compute Units.

Get transaction by version

Retrieves a transaction by a given version. If the version has been pruned, a 410 will be returned.

GEThttps://mainnet.aptos.validationcloud.io/v1/<YOUR_API_KEY_HERE>/v1/transactions/by_version/{txn_version}

Path parameters

txn_version*U64 (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"

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

Transaction (object)

Enum of the different types of transactions in Aptos

type*string

Example: "pending_transaction"

hash*HashValue (string)

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

sequence_number*U64 (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"

max_gas_amount*U64 (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"

gas_unit_price*U64 (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"

expiration_timestamp_secs*U64 (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"

payload*TransactionPayload (object)

An enum of the possible transaction payloads

type*string

Example: "entry_function_payload"

function*EntryFunctionId (string)

Entry function id is string representation of a entry function defined on-chain.

Format: {address}::{module name}::{function name}

Both module name and function name are case-sensitive.

Example: "0x1::aptos_coin::transfer"

type_arguments*array of MoveType (string)

Type arguments of the function

itemsMoveType (string)

String representation of an on-chain Move type tag that is exposed in transaction payload. Values: - bool - u8 - u16 - u32 - u64 - u128 - u256 - address - signer - vector: vector<{non-reference MoveTypeId}> - struct: {address}::{module_name}::{struct_name}::<{generic types}>

Vector type value examples:
  - `vector<u8>`
  - `vector<vector<u64>>`
  - `vector<0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>>`

Struct type value examples:
  - `0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>
  - `0x1::account::Account`

Note:
  1. Empty chars should be ignored when comparing 2 struct tag ids.
  2. When used in an URL path, should be encoded by url-encoding (AKA percent-encoding).

arguments*array of any

Arguments of the function

itemsany

signatureTransactionSignature (object)

An enum representing the different transaction signatures available

type*string

Example: "ed25519_signature"

public_key*HexEncodedBytes (string (hex))

All bytes (Vec) data is represented as hex-encoded string prefixed with 0x and fulfilled with two hex digits per byte.

Unlike the Address type, HexEncodedBytes will not trim any zeros.

Example: "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 "

signature*HexEncodedBytes (string (hex))

All bytes (Vec) data is represented as hex-encoded string prefixed with 0x and fulfilled with two hex digits per byte.

Unlike the Address type, HexEncodedBytes will not trim any zeros.

Example: "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 "

Request

Response

Get transaction by version

Retrieves a transaction by a given version. If the version has been pruned, a 410 will be returned.

GEThttps://mainnet.aptos.validationcloud.io/v1/<YOUR_API_KEY_HERE>/v1/transactions/by_version/{txn_version}

Path parameters

txn_version*U64 (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"

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

Transaction (object)

Enum of the different types of transactions in Aptos

type*string

Example: "pending_transaction"

hash*HashValue (string)

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

sequence_number*U64 (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"

max_gas_amount*U64 (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"

gas_unit_price*U64 (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"

expiration_timestamp_secs*U64 (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"

payload*TransactionPayload (object)

An enum of the possible transaction payloads

type*string

Example: "entry_function_payload"

function*EntryFunctionId (string)

Entry function id is string representation of a entry function defined on-chain.

Format: {address}::{module name}::{function name}

Both module name and function name are case-sensitive.

Example: "0x1::aptos_coin::transfer"

type_arguments*array of MoveType (string)

Type arguments of the function

itemsMoveType (string)

Vector type value examples:
  - `vector<u8>`
  - `vector<vector<u64>>`
  - `vector<0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>>`

Struct type value examples:
  - `0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>
  - `0x1::account::Account`

Note:
  1. Empty chars should be ignored when comparing 2 struct tag ids.
  2. When used in an URL path, should be encoded by url-encoding (AKA percent-encoding).

arguments*array of any

Arguments of the function

itemsany

signatureTransactionSignature (object)

An enum representing the different transaction signatures available

type*string

Example: "ed25519_signature"

public_key*HexEncodedBytes (string (hex))

All bytes (Vec) data is represented as hex-encoded string prefixed with 0x and fulfilled with two hex digits per byte.

Unlike the Address type, HexEncodedBytes will not trim any zeros.

Example: "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 "

signature*HexEncodedBytes (string (hex))

All bytes (Vec) data is represented as hex-encoded string prefixed with 0x and fulfilled with two hex digits per byte.

Unlike the Address type, HexEncodedBytes will not trim any zeros.

Example: "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 "

Request

Response

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

{
  "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 "
  }
}