getBlocks

POSTBlocksBlade Runner+

Returns confirmed block slot numbers within a given range, skipping any slots that were never produced.

Try itSends a real request from your browser to the selected region.
POST
/

getBlocks lists which slots in a range have a produced block, given a start and optional end slot, letting an indexer walk the chain sequentially without calling getBlock on skipped slots.

The range is capped server-side: a large span returns as much as the node allows, not necessarily all of it.

Plans & rate limitsBlade Runner and above
FreeNot included
OperatorNot included
Blade Runner10/s
Nexus30/s

Parameters

params is a JSON array, with values in this order: startSlot, endSlot, config.

1startSlotintegerrequired

First slot of the range, inclusive.

2endSlotinteger

Last slot of the range, inclusive. Omit to let the node default to startSlot plus its maximum allowed range, or the current highest confirmed slot, whichever is smaller.

3configobject

Optional configuration.

Show propertiesProperties
commitmentstringdefault: "finalized"

Bank state to list blocks from. processed is not accepted here.

Allowed values:confirmedfinalized

Result

resultinteger[]

Slot numbers of every produced block in the range, ascending. Not wrapped in a context/value envelope.

Notes

  • Skipped slots do not appear in the array; there is no placeholder or marker for them.
  • constant-k retains a rolling window of ledger history; a range reaching further back is truncated to what is available, and minimumLedgerSlot reports the oldest slot in range.
  • Blade Runner and above only — not available on Free or Operator.