txpool_status - Polygon RPC Method
Inspect pending and queued transaction counts in the Polygon transaction pool. Useful for mempool monitoring, congestion analysis, and node health checks.
Returns transaction pool counters for the connected Polygon endpoint. The result separates transactions that are immediately processable (pending) from those waiting on an earlier nonce or other prerequisite (queued).
Non-standard method.
txpool_statusis a Geth-style mempool inspection method. It is not part of the core Ethereum Execution API method set, and many shared RPC endpoints disable it.
Why Polygon? Build on the most adopted Ethereum scaling solution with 45,000+ dApps and enterprise partnerships with $4B+ TVL, sub-$0.01 transactions, 8M+ daily transactions, and zkEVM for enhanced security.
When to Use This Method
txpool_status is valuable for enterprise developers, gaming studios, and teams building high-throughput applications:
- Mempool Monitoring — Watch pending versus queued pressure on a node
- Congestion Signals — Detect bursts of transaction backlog before they show up in block-level metrics
- Node Health Checks — Confirm a node is accepting and classifying new transactions as expected
- Operational Dashboards — Surface lightweight txpool counters without pulling full transaction content
Request Parameters
This method accepts no parameters.
Response Body
Number of processable transactions currently in the pool
Number of transactions waiting on an earlier prerequisite such as nonce order
Error Responses
Code Examples
curl -X POST https://api-polygon-mainnet-full.n.dwellir.com/YOUR_API_KEY \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "txpool_status",
"params": [],
"id": 1
}'Error Handling
| Error Code | Message | Description |
|---|---|---|
| -32601 | Method not found | The endpoint does not expose txpool methods |
| -32603 | Internal error | The node rejected or failed to process the request |
Related Methods
txpool_content- Inspect the full pending and queued transaction mapseth_blockNumber- Track block production alongside mempool pressureeth_gasPrice- Compare congestion signals with fee estimates
rpc_modules
Inspect which JSON-RPC namespaces are enabled on your Polygon endpoint. Useful for capability checks, client diagnostics, and RPC feature discovery.
txpool_content
Inspect the full pending and queued transaction pool on Polygon. Useful for mempool analytics, transaction replacement debugging, and operational monitoring.