Skip to main content

Services documentation

Use high performance APIs provided by Infura to scale your dapp or Snap.

getLeaderSchedule

Returns the leader schedule for an epoch. This method uses 160 credits from your daily balance.

Parameters

  • slot: (integer) [optional] - The slot number to query. The method returns the leader schedule for the epoch that corresponds to the provided slot. If unspecified, returns the leader schedule for the current epoch.
  • config: (object) [optional] - Configuration object with the following options:
    • commitment: (string) [optional] - The commitment level to use for the query. The default is finalized. Possible values are:
      • finalized - Queries the most recent block confirmed by a super majority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
      • confirmed - Queries the most recent block that has been voted on by a super majority of the cluster.
      • processed - Queries its most recent block. The block may still be skipped by the cluster.
    • identity: (string) [optional] - Only return results for this base58 encoded validator identity.

Returns

result - null if the requested epoch is not found; otherwise, an object of base58 encoded validator identities, and their corresponding leader slot indices as values (indices are relative to the first slot in the requested epoch).

Request

curl https://solana-mainnet.infura.io/v3/<YOUR-API-KEY> \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0", "id":1, "method":"getLeaderSchedule", "params":[{"identity":"3zvXem8vqvDYos6BKu66FV84tmDdQwgLxYSempy8tSrs"}]}'

Response

{
"jsonrpc": "2.0",
"result": {
"3zvXem8vqvDYos6BKu66FV84tmDdQwgLxYSempy8tSrs": [
2816,
2817,
2818,
...
430998,
430999
]
},
"id": 1
}