getBlocksWithLimit

POSTBlocksBlade Runner+

Returns up to `limit` confirmed block slot numbers starting from a given slot.

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

getBlocksWithLimit is getBlocks with a count instead of an end slot: it returns up to limit produced-block slot numbers starting at startSlot, fewer if history runs out.

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, limit, config.

1startSlotintegerrequired

First slot to start looking from, inclusive.

2limitintegerrequired

Maximum number of produced-block slots to return.

Minimum: 1
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 produced blocks starting at startSlot, ascending, capped at limit entries. Not wrapped in a context/value envelope.

Notes

  • The server also enforces its own upper cap on limit; very large requests are clamped, not rejected.
  • Blade Runner and above only — not available on Free or Operator, matching getBlocks.