getBlockHeight

Returns the current block height of the node, which represents the number of blocks that have been confirmed by the cluster. Block height monotonically increases and is useful for tracking network progress, implementing block-based timeouts, and synchronizing services with the chain tip.

Parameters

#TypeRequiredDescription
1objectNoConfiguration object

Configuration object fields:

FieldTypeDescription
commitmentstringCommitment level: processed, confirmed, or finalized
minContextSlotnumberMinimum slot at which the request can be evaluated

Response

Returns a single value:

FieldTypeDescription
resultu64The current block height

Code Examples

cURL

1curl http://[IP_ADDRESS]:[PORT] -X POST -H "Content-Type: application/json" -d '{
2  "jsonrpc": "2.0",
3  "id": 1,
4  "method": "getBlockHeight",
5  "params": [
6    { "commitment": "finalized" }
7  ]
8}'

TypeScript

1const response = await fetch("http://[IP_ADDRESS]:[PORT]", {
2  method: "POST",
3  headers: { "Content-Type": "application/json" },
4  body: JSON.stringify({
5    jsonrpc: "2.0",
6    id: 1,
7    method: "getBlockHeight",
8    params: [
9      { commitment: "finalized" }
10    ]
11  }),
12});
13const { result } = await response.json();
14console.log("Block height:", result);

Python

1import requests
2
3response = requests.post("http://[IP_ADDRESS]:[PORT]", json={
4    "jsonrpc": "2.0",
5    "id": 1,
6    "method": "getBlockHeight",
7    "params": [
8        {"commitment": "finalized"}
9    ]
10})
11result = response.json()["result"]
12print(f"Block height: {result}")

Rust

1use reqwest::Client;
2use serde_json::json;
3
4#[tokio::main]
5async fn main() -> Result<(), Box<dyn std::error::Error>> {
6    let client = Client::new();
7    let res = client.post("http://[IP_ADDRESS]:[PORT]")
8        .json(&json!({
9            "jsonrpc": "2.0",
10            "id": 1,
11            "method": "getBlockHeight",
12            "params": [
13                {"commitment": "finalized"}
14            ]
15        }))
16        .send().await?
17        .text().await?;
18    println!("{}", res);
19    Ok(())
20}

Example Response

1{
2  "jsonrpc": "2.0",
3  "result": 150676031,
4  "id": 1
5}
PreviousgetSlotLeadersNextgetBlockTime