Skip to main content

getBlocksWithLimit

POST
Returns a list of confirmed blocks starting at the given slot
param[0]
startSlotintegerrequired
The slot number.
param[1]
limitintegerrequired
Limit (must be no more than 500,000 blocks higher than the start_slot)
param[2]
configurationObjectobjectrequired
commitmentstring
The commitment describes how finalized a block is at that point in time.
  • finalized - the node will query the most recent block confirmed by supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized
  • confirmed - the node will query the most recent block that has been voted on by supermajority of the cluster.
  • processed - the node will query its most recent block. Note that the block may still be skipped by the cluster.
Responses
idinteger
The request ID
jsonrpcstring
The JSON-RPC version
resultarray
An array of u64 integers listing confirmed blocks starting at start_slot for up to limit blocks, inclusive.
codestringrequired
Code identifying the cause of the failed request.
messagestringrequired
Detailed message including the name and value of the invalid parameter.
{
  "code": "ERROR_CODE",
  "message": "Bad Request"
}
cURL
curl -X POST 'https://solana-mainnet.nodit.io' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBlocksWithLimit",
    "params": [
      338967300,
      10,
      {
        "commitment": "processed"
      }
    ]
  }'