getnetworkinfo

curl --request POST \
  --url https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "1.0",
  "method": "getnetworkinfo",
  "params": "<unknown>",
  "id": 1
}
'

import requests

url = "https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f"

payload = {
    "jsonrpc": "1.0",
    "method": "getnetworkinfo",
    "params": "<unknown>",
    "id": 1
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({jsonrpc: '1.0', method: 'getnetworkinfo', params: '<unknown>', id: 1})
};

fetch('https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '1.0',
    'method' => 'getnetworkinfo',
    'params' => '<unknown>',
    'id' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getnetworkinfo\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getnetworkinfo\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getnetworkinfo\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "result": {},
  "error": {},
  "id": 123
}

POST

e125e5e68e66f2939f3f120e6f888b3f

getnetworkinfo

curl --request POST \
  --url https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "1.0",
  "method": "getnetworkinfo",
  "params": "<unknown>",
  "id": 1
}
'

import requests

url = "https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f"

payload = {
    "jsonrpc": "1.0",
    "method": "getnetworkinfo",
    "params": "<unknown>",
    "id": 1
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({jsonrpc: '1.0', method: 'getnetworkinfo', params: '<unknown>', id: 1})
};

fetch('https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '1.0',
    'method' => 'getnetworkinfo',
    'params' => '<unknown>',
    'id' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getnetworkinfo\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getnetworkinfo\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://bitcoin-mainnet.core.chainstack.com/e125e5e68e66f2939f3f120e6f888b3f")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getnetworkinfo\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "result": {},
  "error": {},
  "id": 123
}

The getnetworkinfo method provides comprehensive information about the node’s network connections, including the version, protocol, connected peers, and network capabilities.

Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

None

Response

result — an object containing detailed information about the node’s network connections, such as the network version, protocol version, number of connections, and available network services.
error — an object containing an error message if an error occurred, otherwise null.
id — an integer representing the ID of the request.

Use case

The getnetworkinfo method is essential for diagnosing network issues, understanding the node’s connectivity within the network, and assessing the node’s capabilities. It’s particularly useful for node operators and developers looking to monitor network health and performance.

Body

application/json

jsonrpc

string

default:1.0

method

string

default:getnetworkinfo

params

any

integer

default:1

Response

200 - application/json

Detailed information about the node's network connections.

result

object

Contains detailed information about the network connections.

error

object

integer

Last modified on October 23, 2026

APIs introduction

Node APIs

Faucet API

Chainstack platform API

getnetworkinfo | Bitcoin

Parameters

Response

Use case

Body

Response

​Parameters

​Response

​Use case

Body

Response

Parameters

Response

Use case