getMinimumBalanceForRentExemption - Solana

Example code for the getMinimumBalanceForRentExemption JSON-RPC method. Complete guide on how to use the getMinimumBalanceForRentExemption JSON-RPC method in the GetBlock Web3 documentation.

This method returns the minimum lamport balance an account must hold to be exempt from rent collection at a given data size. Accounts below this threshold are subject to rent and can be purged.

Parameters

Parameter	Type	Required	Description
dataLength	number	Yes	Account data length in bytes
config	object	No	Configuration object controlling commitment

Config Object

Field	Type	Required	Description
commitment	string	No	Commitment level: processed, confirmed, or finalized. Defaults to finalized

Request

cURL

curl --location --request POST 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "getMinimumBalanceForRentExemption",
    "params": [165],
    "id": "getblock.io"
}'

@solana/web3.js

example.js

const { Connection } = require('@solana/web3.js');

const connection = new Connection('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/', 'confirmed');

const lamports = await connection.getMinimumBalanceForRentExemption(165);

console.log(lamports);

Request

example.py

import requests

response = requests.post(
    'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/',
    headers={'Content-Type': 'application/json'},
    json={
        'jsonrpc': '2.0',
        'method': 'getMinimumBalanceForRentExemption',
        'params': [165],
        'id': 'getblock.io'
    }
)

print(response.json()['result'])

Rust

example.rs

use reqwest::Client;
use serde_json::{json, Value};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    let response = client
        .post("https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/")
        .header("Content-Type", "application/json")
        .json(&json!({
            "jsonrpc": "2.0",
            "method": "getMinimumBalanceForRentExemption",
            "params": [165],
            "id": "getblock.io"
        }))
        .send()
        .await?
        .json::<Value>()
        .await?;

    println!("Result: {}", response["result"]);
    Ok(())
}

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": 2039280
}

Response Parameters

Parameter	Type	Description
jsonrpc	string	JSON-RPC protocol version ("2.0")
id	string	Request identifier matching the request
result	number	Minimum lamports required for rent exemption at the requested data length

Use Cases

• Account Creation: Fund a new SPL Token account with the exact rent-exempt minimum

• Cost Estimation: Quote storage cost to users before a program allocates state

• PDA Sizing: Compare rent cost across candidate account layouts

• Reclaim Logic: Calculate lamports recoverable when closing an account

Error Handling

Error Code	Message	Description
-32602	Invalid params	dataLength is negative or not an integer
-32603	Internal error	Node failed to read the rent sysvar