getpeerinfo (0.17.99 RPC)
blockchain
control
generating
mining
network
rawtransactions
util
wallet
getpeerinfo
Returns data about each connected network node as a json array of objects.
Result
[ |
||
{ |
||
"id": n, |
numeric |
Peer index |
"addr":"host:port", |
string |
The IP address and port of the peer |
"addrbind":"ip:port", |
string |
Bind address of the connection to the peer |
"addrlocal":"ip:port", |
string |
Local address as reported by the peer |
"services":"xxxxxxxxxxxxxxxx", |
string |
The services offered |
"relaytxes":true|false, |
boolean |
Whether peer has asked us to relay transactions to it |
"lastsend": ttt, |
numeric |
The time in seconds since epoch (Jan 1 1970 GMT) of the last send |
"lastrecv": ttt, |
numeric |
The time in seconds since epoch (Jan 1 1970 GMT) of the last receive |
"bytessent": n, |
numeric |
The total bytes sent |
"bytesrecv": n, |
numeric |
The total bytes received |
"conntime": ttt, |
numeric |
The connection time in seconds since epoch (Jan 1 1970 GMT) |
"timeoffset": ttt, |
numeric |
The time offset in seconds |
"pingtime": n, |
numeric |
ping time (if available) |
"minping": n, |
numeric |
minimum observed ping time (if any at all) |
"pingwait": n, |
numeric |
ping wait (if non-zero) |
"version": v, |
numeric |
The peer version, such as 70001 |
"subver": "/Satoshi:0.8.5/", |
string |
The string version |
"inbound": true|false, |
boolean |
Inbound (true) or Outbound (false) |
"addnode": true|false, |
boolean |
Whether connection was due to addnode/-connect or if it was an automatic/inbound connection |
"startingheight": n, |
numeric |
The starting height (block) of the peer |
"banscore": n, |
numeric |
The ban score |
"synced_headers": n, |
numeric |
The last header we have in common with this peer |
"synced_blocks": n, |
numeric |
The last block we have in common with this peer |
"inflight": [ |
||
n, |
numeric |
The heights of blocks we’re currently asking from this peer |
... |
||
], |
||
"whitelisted": true|false, |
boolean |
Whether the peer is whitelisted |
"minfeefilter": n, |
numeric |
The minimum fee rate for transactions this peer accepts |
"bytessent_per_msg": { |
||
"addr": n, |
numeric |
The total bytes sent aggregated by message type |
... |
||
}, |
||
"bytesrecv_per_msg": { |
||
"addr": n, |
numeric |
The total bytes received aggregated by message type |
... |
||
} |
||
} |
||
,... |
||
] |
Examples
Examples:
bitcoin-cli getpeerinfo
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getpeerinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/