getpeerinfo

curl --request POST \
  --url https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8 \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "1.0",
  "method": "getpeerinfo",
  "params": "<unknown>",
  "id": 1
}
'

import requests

url = "https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8"

payload = {
    "jsonrpc": "1.0",
    "method": "getpeerinfo",
    "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: 'getpeerinfo', params: '<unknown>', id: 1})
};

fetch('https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8', 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://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8",
  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' => 'getpeerinfo',
    '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://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getpeerinfo\",\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://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getpeerinfo\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8")

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\": \"getpeerinfo\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}"

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

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

POST

788f110831fe13808302bd79796d55e8

getpeerinfo

curl --request POST \
  --url https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8 \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "1.0",
  "method": "getpeerinfo",
  "params": "<unknown>",
  "id": 1
}
'

import requests

url = "https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8"

payload = {
    "jsonrpc": "1.0",
    "method": "getpeerinfo",
    "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: 'getpeerinfo', params: '<unknown>', id: 1})
};

fetch('https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8', 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://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8",
  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' => 'getpeerinfo',
    '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://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getpeerinfo\",\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://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getpeerinfo\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8")

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\": \"getpeerinfo\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}"

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

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

The getpeerinfo method provides detailed information about all peers currently connected to the node. This includes data such as their IP address, connection type, version, and more.

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 array of objects, each representing a connected peer and containing detailed information about that peer.
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 getpeerinfo method is useful for network diagnostics and monitoring, allowing node operators to view detailed information about all peers connected to their node. This can help in assessing the health and diversity of the network connections.

Body

application/json

jsonrpc

string

default:1.0

method

string

default:getpeerinfo

params

any

integer

default:1

Response

200 - application/json

Information about each connected peer.

result

object[]

A list of objects containing information about each peer.

error

object

integer

Last modified on June 22, 2026

APIs introduction

Node APIs

Faucet API

Chainstack platform API

getpeerinfo | Bitcoin

Parameters

Response

Use case

Body

Response

​Parameters

​Response

​Use case

Body

Response

Parameters

Response

Use case