POSTGet Ledger By Hash Or Index

Data APIhttps://web3.nodit.io/v1/xrpl/mainnet/blockchain/getLedgerByHashOrIndex

Returns information about a Ledger queried by Ledger hash or index.

Path Parameters
chainstring (enum)required

Parameter to specify the target chain for the query.

networkstring (enum)required

Parameter to specify the network of the target chain. Supported networks may vary depending on the chain.

Request Body
ledgerstringrequired

Parameter specifying the ledger to query. You can enter one of the following formats:

  • ledger index: Ledger number as a decimal string
  • ledger hash: 64-character hexadecimal string (excluding 0x prefix)
  • ledger tag: "earliest" or "latest" (oldest or most recent ledger)
Responses
ledgerHashstringrequired

Unique identifier of the current ledger, a 256-bit (64-digit hexadecimal) cryptographic hash. Used for ledger data integrity verification and identification.

예: 655EB9D740CC572BFFEC725ABB0AA0D813AAF01C91F8577076F29258794D9445

ledgerIndexintegerrequired

Integer value indicating the creation order of the ledger, used to identify its position (sequence number) on the network.

예: 95444296

ledgerTimestampintegerrequired

The ledger's close time converted to a Unix timestamp. The close time recorded in the ledger header is expressed in seconds since the Ripple Epoch (January 1, 2000 00:00 UTC), which differs from the Unix Epoch (January 1, 1970 00:00 UTC) by 946,684,800 seconds. Thus ledgerTimestamp is the recorded close time plus 946,684,800 seconds.

예: 1744608171

parentLedgerHashstringrequired

256-bit (64-digit hexadecimal) hash identifying the ledger immediately preceding the current ledger. References the previous ledger's hash to maintain chain integrity.

예: 45E963AA7A3BB017D626D088C91E6C646B6BBF558DD027AAD974CBBE9A3977D3

accountHashstringrequired

256-bit (64-digit hexadecimal) hash summarizing all account state information recorded in the ledger. Used to verify consistency and integrity of account data.

예: 43DA3A81948A7392D14E4DDFB8215372C4B0590E3B28691C599296E4478B12AC

totalCoinsstringrequired

Total quantity of XRP (in XRP units) owned by accounts recorded in the ledger. This value excludes XRP burned as transaction fees. The actual circulating XRP may be lower than this value because some accounts may be in a "black hole" state (accounts with no key).

예: 99986231517.566048

transactionHashstringrequired

256-bit (64-digit hexadecimal) Merkle tree root hash summarizing all transaction data included in the ledger. Used for transaction history integrity verification.

예: 8BAD7583234AC463E09D6CF160E352DFF5B008FC071DD5226A53809D89E7F409

transactionCountintegerrequired

Integer value indicating the total number of transactions included in the ledger. Used to assess the scale and activity of ledger transaction history.

예: 40

transactionsstring[]required

Array of transaction hashes included in the ledger. Each hash is a 256-bit (64-digit hexadecimal) cryptographic hash uniquely identifying a transaction, used for transaction data integrity and identification.

예: 044CD9B107E209F24F5342393F34493E7AFE99AE6F5051F2D75E186F07E1EAE8,0D1DDF6974EA31918EB531F9212FC76BC47BCE9193839496474010D133C0BB1E,1069423CDB7F19E082E6F418C779B19A0126B593832016D134A679EFB752CF0A

X-API-KEY
RequestCU30
cURL
curl -X POST "https://web3.nodit.io/v1/xrpl/mainnet/blockchain/getLedgerByHashOrIndex" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "ledger": "latest"
}'
Response
Example · 200
{
  "ledgerHash": "655EB9D740CC572BFFEC725ABB0AA0D813AAF01C91F8577076F29258794D9445",
  "ledgerIndex": 95444296,
  "ledgerTimestamp": 1744608171,
  "parentLedgerHash": "45E963AA7A3BB017D626D088C91E6C646B6BBF558DD027AAD974CBBE9A3977D3",
  "accountHash": "43DA3A81948A7392D14E4DDFB8215372C4B0590E3B28691C599296E4478B12AC",
  "totalCoins": "99986231517.566048",
  "transactionHash": "8BAD7583234AC463E09D6CF160E352DFF5B008FC071DD5226A53809D89E7F409",
  "transactionCount": 40,
  "transactions": [
    "044CD9B107E209F24F5342393F34493E7AFE99AE6F5051F2D75E186F07E1EAE8",
    "0D1DDF6974EA31918EB531F9212FC76BC47BCE9193839496474010D133C0BB1E",
    "1069423CDB7F19E082E6F418C779B19A0126B593832016D134A679EFB752CF0A"
  ]
}