getmininginfo - Litecoin

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

Returns a json object containing mining-related information.

Parameters

• None

Request

cURL

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": "getmininginfo",
    "params": [],
    "id": "getblock.io"
}'

Axios (JavaScript)

axios.js

import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "getmininginfo",
    "params": [],
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data)))
    .catch(error => console.log(error));

Python (requests)

request.py

import requests
import json

url = "https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "getmininginfo",
    "params": [],
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

Rust (reqwest)

main.rs

use reqwest::header;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
    
    let response = client
        .post("https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/")
        .header(header::CONTENT_TYPE, "application/json")
        .body(r#"{
            "jsonrpc": "2.0",
            "method": "getmininginfo",
            "params": [],
            "id": "getblock.io"
        }"#)
        .send()
        .await?;
    
    println!("{}", response.text().await?);
    Ok(())
}

Response

response.json

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": {
        "blocks": 2750000,
        "difficulty": 12345678.90,
        "networkhashps": 123456789012345,
        "pooledtx": 100,
        "chain": "main",
        "warnings": ""
    }
}

Response Parameters

Field	Type	Description
blocks	number	The current block.
difficulty	number	The current difficulty.
networkhashps	number	The network hashes per second.
pooledtx	number	The size of the mempool.

Use Case

The getmininginfo method is essential for:

• Mining pool dashboards

• Network statistics

• Hashrate monitoring

• Mining profitability calculators

Error Handling

Status Code	Error Message	Cause
403	Forbidden	Missing or invalid ACCESS-TOKEN.

Integration Notes

The getmininginfo method helps developers build robust applications that interact with the Litecoin blockchain.