GET /ledger/at
GET

/v1/ledger/at

Resolve a datetime to the last ledger closed at or before it (binary search). Close times are rounded to 10 seconds, so a ledger often closes exactly on the time asked. For a day [start, end): its first ledger is the one returned for start when that closed exactly at start, else the next; its last is the one returned for end, or the one before it when that closed exactly at end

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/ledger/at?time=2026-07-01
Query parameterValueDescription
timeunix ms or ISO date (required)
curl 'https://api.xrpl.to/v1/ledger/at?time=2026-07-01'

Response

200Example response1 ms · just now · 0.1 KB · 5 lines
https://api.xrpl.to/v1/ledger/at?time=2026-07-01
{
  "ledger_index": 105288796,
  "close_time": 1782864000000,
  "iterations": 26
}
Shapeas documented
{
  ledger_index,
  close_time,
  clampedToHead?,
  clampedToGenesis?
}

What it does

Resolve a datetime to the last ledger closed at or before it (binary search). Close times are rounded to 10 seconds, so a ledger often closes exactly on the time asked. For a day [start, end): its first ledger is the one returned for start when that closed exactly at start, else the next; its last is the one returned for end, or the one before it when that closed exactly at end

Transaction hashes are 64-character hex. Submit relays whatever you signed: the type list below is what the ledger accepts today. Every transaction type you can submit →
OpenAPI