getLeaderSchedule

POSTSlots & EpochsAll plans

Returns the full slot-leader assignment for an epoch, grouped by validator identity.

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

getLeaderSchedule returns the leader schedule for the epoch containing a given slot: every validator identity mapped to the slots it leads. Returned slot numbers are epoch-relative indexes, not absolute; add the epoch's first slot to convert.

A single fetch per epoch supports looking up leaders locally, instead of calling getSlotLeader or getSlotLeaders per slot.

Plans & rate limitsAll plans
Free5/s
Operator50/s
Blade Runner200/s
Nexus500/s

Parameters

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

1slotinteger | null

Any slot within the target epoch. Omit (pass null) to use the current epoch.

2configobject

Optional configuration.

Show propertiesProperties
commitmentstringdefault: "finalized"

Bank state to compute the schedule from.

Allowed values:finalizedconfirmedprocessed
identitystring

Restrict the result to a single validator identity, base-58 encoded. The response then contains at most one key.

Result

resultobject | null

Map of validator identity to the epoch-relative slot indexes it leads, or null if the epoch's schedule can't be determined (for example, a future epoch too far ahead to have been computed yet).

Show one ofOne of
Option 1object

A dynamic map keyed by validator identity (base-58, not enumerable ahead of time), where each value is an array of integers: the epoch-relative slot indexes (0-based from the epoch's first slot) that identity leads.

Option 2null

Notes

  • Slot numbers are indexes within the epoch (0 at its first slot); adding getEpochInfo's absoluteSlot - slotIndex converts one to an absolute slot.
  • A validator typically leads dozens to hundreds of 4-slot runs per 432,000-slot epoch, depending on stake weight; the example above is trimmed to 3 runs.
  • identity scopes the result to one validator; without it, the response enumerates every leader for the whole epoch.