getnetworkinfo

getnetworkinfo is a Bitcoin Core JSON-RPC method that reports how the node sees the Bitcoin peer-to-peer network along with its own software identity and relay policy. The response carries the Core version and subversion, the P2P protocolversion, whether networking is active, inbound and outbound connections, the list of reachable networks, and the relayfee and incrementalfee that govern which BTC transactions the node will accept and forward. Call it against https://bitcoin.therpc.io/YOUR_API_KEY to get the node's view of the P2P network plus its version and relay settings.

Use cases

• Read the version and subversion strings to learn which Bitcoin Core build the endpoint runs, useful for feature gating.
• Pull relayfee and incrementalfee to set sensible fee floors so your BTC transactions clear the node's mempool and relay rules.
• Check networkactive and the inbound/outbound connections counts as a quick health signal for the upstream node.

Parameters

此方法不需要任何参数，传入空数组 [] 即可。

Response

Example request

1curl https://bitcoin.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "1.0",
6  "id": "therpc",
7  "method": "getnetworkinfo",
8  "params": []
9}'

Errors & troubleshooting

Common pitfalls

• Every field describes the provider's upstream node, not your own connectivity. The connections count and localaddresses belong to that node, so do not treat them as your client's network state.
• relayfee and incrementalfee are quoted in BTC per kvB. For sat/vB fee math, multiply by 1e8 to get satoshis and divide by 1000 — e.g. a relayfee of 0.00001 BTC/kvB is 1 sat/vB.

Supported networks

• Mainnet
• Testnet

See also

• getmininginfo
• getblockchaininfo
• estimatesmartfee