TriportRPC
DashboardDocs

admin_peers

Last updated:

`admin_peers` returns an array describing every remote peer the backing Ethereum node is connected to. Each entry carries the peer's enode/enr identity, the negotiated devp2p capabilities, the network endpoints, and the per-protocol handshake state (for example the `eth` protocol version and the head block the peer advertised).

This method belongs to the `eth_peergraph` category and is restricted to the **Business** tier. It is an operational / introspection call — use it to inspect node topology and peer health alongside [admin_nodeInfo](./admin_nodeInfo.md) and [admin_datadir](./admin_datadir.md), not to serve end-user requests. The data reflects the specific node serving your request, so the peer set and its size will vary between calls and between nodes.

It takes no parameters.

Parameters

This method takes no parameters.

Returns

admin_peers return value
FieldType
resultobject

Examples

curl https://<your-endpoint>/ \
  -X POST -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"admin_peers","params":[]}'
const res = await fetch("https://<your-endpoint>/", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
  "id": 1,
  "method": "admin_peers",
  "params": [],
  "jsonrpc": "2.0"
}),
});
const data = await res.json();
import requests
resp = requests.post("https://<your-endpoint>/", json={"id":1,"method":"admin_peers","params":[],"jsonrpc":"2.0"})
print(resp.json())

Usage

  1. Transport: HTTP (JSON-RPC).
  2. Networks: mainnet.
  3. Credit cost: 1 per call.

FAQ

What does admin_peers do?
Returns the set of peers the Ethereum node is currently connected to, with their identity, network, and protocol details.
How many credits does admin_peers cost?
admin_peers costs 1 credit(s) per call on Triport by default.
Is admin_peers available over WebSocket?
admin_peers is an HTTP JSON-RPC method.