Get ledger info

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

If the duration_secs param is provided, this endpoint will return a 200 if the following condition is true:

server_latest_ledger_info_timestamp >= server_current_time_timestamp - duration_secs

Path Parameters:

None

Query Parameters：

None

Response Header:

X-APTOS-BLOCK-HEIGHT integer

Current block height of the chain

X-APTOS-CHAIN-ID integer

Chain ID of the current chain

X-APTOS-EPOCH integer

Current epoch of the chain

X-APTOS-LEDGER-OLDEST-VERSION integer

Oldest non-pruned ledger version of the chain

X-APTOS-LEDGER-TIMESTAMPUSEC integer

Current timestamp of the chain

X-APTOS-LEDGER-VERSION integer

Current ledger version of the chain

X-APTOS-OLDEST-BLOCK-HEIGHT integer

Oldest non-pruned block height of the chain

Response Body:

The struct holding all data returned to the client by the index endpoint (i.e., GET "/"). Only for responding in JSON

chain_id integer

Chain ID of the current chain

epoch string<uint64>

A string containing a 64-bit unsigned integer.

ledger_version string<uint64>

A string containing a 64-bit unsigned integer.

oldest_ledger_version string<uint64>

A string containing a 64-bit unsigned integer.

ledger_timestamp string<uint64>

A string containing a 64-bit unsigned integer.

node_role string

Allowed values: validator full_node

oldest_block_height string<uint64>

A string containing a 64-bit unsigned integer.

block_height string<uint64>

A string containing a 64-bit unsigned integer.

git_hash string

Example:

// Request
curl -X GET -H 'Content-Type: application/json' https://movement.blockpi.network/rpc/v1/your_api_key/v1/

// Result
{
    "chain_id": 126,
    "epoch": "1",
    "ledger_version": "9",
    "oldest_ledger_version": "0",
    "ledger_timestamp": "1732636319660843",
    "node_role": "validator",
    "oldest_block_height": "0",
    "block_height": "3",
    "git_hash": "9dfc8e7a3d622597dfd81cc4ba480a5377f87a41"
}