uptime - Bitcoin

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

This method returns the total uptime of the server in seconds.

Parameters

None

Request

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

import axios from 'axios';

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

const config = {
    method: 'post',
    url: 'https://go.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));

import requests
import json

url = "https://go.getblock.io/<ACCESS-TOKEN>/"

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

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

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

use reqwest::header;

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

Response

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

Response Parameters

Field

Type

Description

result

number

The server uptime in seconds.

Use Case

The uptime method is essential for:

Monitoring node stability
Building health check systems
SLA tracking and reporting
Node reliability metrics
Operational dashboards
Detecting node restarts

Error Handling

Status Code

Error Message

Cause

403

Forbidden

Missing or invalid ACCESS-TOKEN.

Integration With Web3

The uptime method helps developers:

Monitor node availability
Track service reliability
Build uptime monitoring tools
Create operational alerts
Support SLA compliance

Previousupgradewallet {disallowed} - Bitcoin Nextutxoupdatepsbt - Bitcoin

Last updated 1 month ago

Was this helpful?

hashtagParameters

hashtagRequest

hashtagResponse

hashtagResponse Parameters

hashtagUse Case

hashtagError Handling

hashtagIntegration With Web3