minimumLedgerSlot
Last updated:
`minimumLedgerSlot` returns the **lowest slot the node has any information about in its ledger**. As the ledger is trimmed by the node's retention policy, this floor advances over time, so it marks the oldest point from which raw ledger data may still be available.
Use it to discover the earliest slot you can attempt to query against a node — for example, before walking historical slots or calling block/transaction reads on old data. If you request data below this floor, the node no longer holds it.
> **Gotcha — not the same as the confirmed-block floor** > This value may be **lower** than [`getFirstAvailableBlock`](./getFirstAvailableBlock.md). > `minimumLedgerSlot` counts *any* ledger data the node retains, while > `getFirstAvailableBlock` reports the earliest **confirmed block** available. > A slot can be at or above `minimumLedgerSlot` yet still have no confirmed block > to fetch. When you need a slot you can actually read a block from, prefer > `getFirstAvailableBlock` as the floor.
Parameters
This method takes no parameters.
Returns
| Field | Type |
|---|---|
| result | object |
Examples
curl https://<your-endpoint>/ \
-X POST -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"minimumLedgerSlot","params":[]}'const res = await fetch("https://<your-endpoint>/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"id": 1,
"method": "minimumLedgerSlot",
"params": [],
"jsonrpc": "2.0"
}),
});
const data = await res.json();import requests
resp = requests.post("https://<your-endpoint>/", json={"id":1,"method":"minimumLedgerSlot","params":[],"jsonrpc":"2.0"})
print(resp.json())Usage
- Transport: HTTP (JSON-RPC).
- Networks: mainnet, devnet, testnet.
- Credit cost: 1 per call.
FAQ
- What does minimumLedgerSlot do?
- Returns the lowest slot for which the node currently has any ledger data.
- How many credits does minimumLedgerSlot cost?
- minimumLedgerSlot costs 1 credit(s) per call on Triport by default.
- Is minimumLedgerSlot available over WebSocket?
- minimumLedgerSlot is an HTTP JSON-RPC method.