Get Ledger Info

Get the latest ledger information, including data such as chain ID, role type, ledger versions, epoch, etc.

This method will use 10 Compute Units.

---

Get ledger info

Get the latest ledger information, including data such as chain ID, role type, ledger versions, epoch, etc.

GEThttps://mainnet.aptos.validationcloud.io/v1/<YOUR_API_KEY_HERE>/v1/

Response

200400403500503

Headers

Body

application/jsonapplication/x-bcs

chain_id*integer (uint8)

Chain ID of the current chain

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

ledger_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"

oldest_ledger_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"

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

node_role*RoleType (enum)

validatorfull_node

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

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

git_hashstring

Git hash of the build of the API endpoint. Can be used to determine the exact software version used by the API endpoint.

Request

JavaScriptCurl

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

Response

{
  "epoch": "32425224034",
  "ledger_version": "32425224034",
  "oldest_ledger_version": "32425224034",
  "ledger_timestamp": "32425224034",
  "node_role": "validator",
  "oldest_block_height": "32425224034",
  "block_height": "32425224034",
  "git_hash": "text"
}