Get Ledger Info

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

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

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.

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.

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.

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.

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.

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.

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>/', {
    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"
}