txpool_status

The txpool_status method returns the number of pending and queued transactions in the transaction pool. This lightweight method provides a quick overview of mempool activity by returning simple counts of transactions in different states, making it much more efficient than txpool_content for monitoring purposes.

This method is perfect for monitoring transaction pool congestion levels, tracking network activity patterns, building dashboards that display mempool size, determining if there are transactions waiting to be processed, and triggering alerts when the mempool is unusually full or empty. The method is very fast since it only returns counts rather than full transaction data, making it suitable for frequent polling. Understanding the difference between pending and queued helps assess how efficiently transactions are flowing through the network.

This method is only available on nodes with txpool enabled.

Parameters

This method does not require any parameters.

Return Object

field	type	description
pending	string	The number of transactions in the pending pool (hexadecimal). These transactions have consecutive nonces starting from the account's current nonce and are ready to be included in the next block
queued	string	The number of transactions in the queued pool (hexadecimal). These transactions have nonce gaps and are waiting for preceding transactions to be mined before they can move to the pending pool

High pending counts indicate network congestion or high transaction volume. High queued counts may indicate issues with transaction submission or nonce management.

Request Example

Request

Response Example

Response