Skip to main content
POST
getBlocksWithLimit
curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getBlocksWithLimit",
  "params": [
    5,
    3
  ]
}
'
{
  "jsonrpc": "2.0",
  "id": "1",
  "result": [
    5,
    6,
    7
  ]
}

​
Request Parameters

​
start_slot
number
Starting Solana slot number from which to begin retrieving the sequential block list.
​
limit
number
Maximum number of sequential blocks to return (up to 500,000 blocks per request).
​
commitment
string
Finality level to query blocks at - either confirmed (optimistic confirmation) or finalized (full confirmation).
  • confirmed
  • finalized

Authorizations

​
api-key
string
query
required

Your Helius API key. You can get one for free in the dashboard.

Body

application/json
​
jsonrpc
enum<string>
default:2.0
required

The JSON-RPC protocol version.

Available options:
2.0
Example:

"2.0"

​
id
string
default:1
required

A unique identifier for the request.

Example:

"1"

​
method
enum<string>
default:getBlocksWithLimit
required

The name of the RPC method to invoke.

Available options:
getBlocksWithLimit
Example:

"getBlocksWithLimit"

​
params
object[]
required

Request parameters for the method.

Response

Successfully retrieved confirmed blocks.

​
jsonrpc
enum<string>

The JSON-RPC protocol version.

Available options:
2.0
Example:

"2.0"

​
id
string

Identifier matching the request.

Example:

"1"

​
result
integer[]

Ordered list of confirmed Solana block slot numbers in ascending sequence starting from the requested slot.

Example:
[5, 6, 7]