Please note that for this RPC method, block range limits are set to 5 for Free Trial plans and 1005 for all paid accounts.

Parameters

start_slot

string

REQUIRED

The start slot encoded as an u64 integer

limit

string

REQUIRED

The limit encoded as u64, 64-bit unsigned integer

object

object

The configuration object with the following fields:

commitment

string

The level of commitment required for the query. It can be one of:

finalized

string

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

string

The node will query the most recent block that has been voted on by supermajority of the cluster

Returns

result

An array of u64 integers listing confirmed blocks between the start_slot and either end_slot - if provided, or latest confirmed block, inclusive. The maximum range allowed is 500,000 slots

Request

1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
-X POST \
3
-H "Content-Type: application/json" \
4
-d $'
5
  {
6
    "jsonrpc": "2.0",
7
    "id":1,
8
    "method":"getBlocksWithLimit",
9
    "params":[5, 3]
10
  }
11
'

1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
-X POST \
3
-H "Content-Type: application/json" \
4
-d $'
5
  {
6
    "jsonrpc": "2.0",
7
    "id":1,
8
    "method":"getBlocksWithLimit",
9
    "params":[5, 3]
10
  }
11
'

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.solana-mainnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "id": 1,
15
  "method": "getBlocksWithLimit",
16
  "params": [
17
    5,
18
    3
19
  ]
20
})
21

22
response = https.request(request)
23
puts response.read_body
24

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.solana-mainnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "id": 1,
15
  "method": "getBlocksWithLimit",
16
  "params": [
17
    5,
18
    3
19
  ]
20
})
21

22
response = https.request(request)
23
puts response.read_body
24

1
import { createSolanaRpc } from "@solana/kit";
2

3
(async () => {
4
  const solanaRpc = createSolanaRpc("https://docs-demo.solana-mainnet.quiknode.pro/");
5

6
  try {
7
    const blocks = await solanaRpc.getBlocksWithLimit(BigInt(5), 3).send();
8
    console.log(blocks);
9
  } catch (error) {
10
    console.error("Error fetching blocks with limit:", error);
11
  }
12
})();

1
import { createSolanaRpc } from "@solana/kit";
2

3
(async () => {
4
  const solanaRpc = createSolanaRpc("https://docs-demo.solana-mainnet.quiknode.pro/");
5

6
  try {
7
    const blocks = await solanaRpc.getBlocksWithLimit(BigInt(5), 3).send();
8
    console.log(blocks);
9
  } catch (error) {
10
    console.error("Error fetching blocks with limit:", error);
11
  }
12
})();

1
// not currently supported by solanaJS
2
const axios = require("axios");
3
(() => {
4
  const config = {
5
    headers: {
6
      "Content-Type": "application/json",
7
    },
8
  };
9
  const data = {
10
    jsonrpc: "2.0",
11
    id: 1,
12
    method: "getBlocksWithLimit",
13
    params: [5, 3],
14
  };
15
  axios
16
    .post("https://docs-demo.solana-mainnet.quiknode.pro/", data, config)
17
    .then(function (response) {
18
      // handle success
19
      console.log(response.data);
20
    })
21
    .catch((err) => {
22
      // handle error
23
      console.log(err);
24
    });
25
})();
26

1
// not currently supported by solanaJS
2
const axios = require("axios");
3
(() => {
4
  const config = {
5
    headers: {
6
      "Content-Type": "application/json",
7
    },
8
  };
9
  const data = {
10
    jsonrpc: "2.0",
11
    id: 1,
12
    method: "getBlocksWithLimit",
13
    params: [5, 3],
14
  };
15
  axios
16
    .post("https://docs-demo.solana-mainnet.quiknode.pro/", data, config)
17
    .then(function (response) {
18
      // handle success
19
      console.log(response.data);
20
    })
21
    .catch((err) => {
22
      // handle error
23
      console.log(err);
24
    });
25
})();
26

1
from jsonrpcclient import request, parse, Ok
2
import logging
3
import requests
4
response = requests.post("https://docs-demo.solana-mainnet.quiknode.pro/",json=request("getBlocksWithLimit", params=[5,3]))
5
parsed = parse(response.json())
6
if isinstance(parsed, Ok):
7
    print(parsed.result)
8
else:
9
    logging.error(parsed.message)
10

1
from jsonrpcclient import request, parse, Ok
2
import logging
3
import requests
4
response = requests.post("https://docs-demo.solana-mainnet.quiknode.pro/",json=request("getBlocksWithLimit", params=[5,3]))
5
parsed = parse(response.json())
6
if isinstance(parsed, Ok):
7
    print(parsed.result)
8
else:
9
    logging.error(parsed.message)
10

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

5
#[tokio::main]
6
async fn main() -> Result<(), Box<dyn Error>> {
7
    let mut headers = header::HeaderMap::new();
8
    headers.insert("Content-Type", "application/json".parse().unwrap());
9

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "jsonrpc": "2.0",
14
        "id": 1,
15
        "method": "getBlocksWithLimit",
16
        "params": [
17
            5,
18
            3
19
        ]
20
    }
21
    "#;
22
    let response = client
23
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
24
        .headers(headers)
25
        .body(json_data)
26
        .send()
27
        .await?; 
28

29
    let body = response.text().await?;
30
    println!("{}", body);
31

32
    Ok(())
33
}
34

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

5
#[tokio::main]
6
async fn main() -> Result<(), Box<dyn Error>> {
7
    let mut headers = header::HeaderMap::new();
8
    headers.insert("Content-Type", "application/json".parse().unwrap());
9

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "jsonrpc": "2.0",
14
        "id": 1,
15
        "method": "getBlocksWithLimit",
16
        "params": [
17
            5,
18
            3
19
        ]
20
    }
21
    "#;
22
    let response = client
23
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
24
        .headers(headers)
25
        .body(json_data)
26
        .send()
27
        .await?; 
28

29
    let body = response.text().await?;
30
    println!("{}", body);
31

32
    Ok(())
33
}
34

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getBlocksWithLimit',
7
  [
8
  5,
9
  3
10
],
11
  undefined,
12
  'https://docs-demo.solana-mainnet.quiknode.pro/'
13
)
14

15
console.log(result)

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getBlocksWithLimit',
7
  [
8
  5,
9
  3
10
],
11
  undefined,
12
  'https://docs-demo.solana-mainnet.quiknode.pro/'
13
)
14

15
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "getBlocksWithLimit",
8
        [
9
            5,
10
            3
11
        ],
12
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
13
    )
14
    print(result)
15

16
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "getBlocksWithLimit",
8
        [
9
            5,
10
            3
11
        ],
12
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
13
    )
14
    print(result)
15

16
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "getBlocksWithLimit",
7
  params: [
8
    5,
9
    3
10
  ],
11
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
12
)
13

14
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "getBlocksWithLimit",
7
  params: [
8
    5,
9
    3
10
  ],
11
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
12
)
13

14
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "getBlocksWithLimit",
10
            Some(serde_json::json!([
11
    5,
12
    3
13
])),
14
            None,
15
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
16
        )
17
        .await?;
18

19
    println!("{result}");
20
    Ok(())
21
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "getBlocksWithLimit",
10
            Some(serde_json::json!([
11
    5,
12
    3
13
])),
14
            None,
15
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
16
        )
17
        .await?;
18

19
    println!("{result}");
20
    Ok(())
21
}

Response

1
{
2
  "jsonrpc": "2.0",
3
  "result": [
4
    5,
5
    6,
6
    7
7
  ],
8
  "id": 1
9
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": [
4
    5,
5
    6,
6
    7
7
  ],
8
  "id": 1
9
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free