txpool_status - Tempo RPC Method
Inspect pending and queued transaction counts in the Tempo transaction pool. Useful for mempool monitoring, congestion analysis, and node health checks.
Returns transaction pool counters for the connected Tempo 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 Tempo? Build on a payments-first EVM chain with deterministic settlement and stablecoin-native fees with no native gas token, fees denominated in supported USD stablecoins, and full EVM RPC compatibility.
When to Use This Method
txpool_status is valuable for payment application developers, wallet teams, stablecoin issuers, and treasury automation builders:
- 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-tempo-mainnet.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 Tempo endpoint. Useful for capability checks, client diagnostics, and RPC feature discovery.
txpool_content
Inspect the full pending and queued transaction pool on Tempo. Useful for mempool analytics, transaction replacement debugging, and operational monitoring.