net_listening

net_listening returns a boolean telling you whether an Avalanche C-Chain node is actively listening for incoming peer-to-peer connections. A true result means the client has its networking layer up and accepting peers; false means it is not. It is one of the simplest health signals for a node on the C-Chain — the EVM chain where AVAX pays for gas, secured by Snowman/Avalanche consensus. Send the request to https://avalanche.therpc.io/YOUR_API_KEY (chain ID 43114, 0xa86a) as a lightweight reachability probe.

Use cases

• Use it as a basic liveness check in monitoring scripts that watch your Avalanche C-Chain endpoint, alerting if the node stops listening.
• Verify a node is reachable and accepting peers before kicking off automated operations such as a batch of AVAX transfers or contract calls.

Parameters

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

Response

Example request

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

Try it live in the Avalanche playground.

Errors & troubleshooting

Common pitfalls

• A true response only means the node is listening, not that it has any peers connected. To confirm the node is actually meshed into the C-Chain network, pair this with net_peerCount.
• Managed RPC endpoints like https://avalanche.therpc.io/YOUR_API_KEY sit behind load balancers and typically return true as long as the gateway is up, regardless of any single backend node's state — so do not read it as a deep diagnostic of one machine.

Supported networks

• Mainnet — Chain ID: 43114
• Fuji

See also

• net_peerCount
• net_version

1curl https://avalanche.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"net_listening","params":[]}'