TriportRPC
DashboardDocs

txpool_status

Last updated:

`txpool_status` reports the current depth of the node's transaction pool: how many transactions are **pending** (ready to be included in the next block) and how many are **queued** (valid but not yet executable, e.g. waiting on a nonce gap or balance). Both counts are returned as hex-encoded integers.

Use it for lightweight monitoring of mempool pressure — dashboards, alerting on queue depth, or deciding whether to bump gas before submitting a transaction. It is the cheap counterpart to `txpool_content`: where `txpool_content` returns the full transaction objects (which can be very large), `txpool_status` returns only the two counts, so it is the right choice when you just need queue depth.

The counts reflect the state of the pool on the node that serves your request at the moment it is answered; they are a point-in-time snapshot and will vary between calls.

Parameters

This method takes no parameters.

Returns

txpool_status return value
FieldType
resultobject

Examples

curl https://<your-endpoint>/ \
  -X POST -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"txpool_status","params":[]}'
const res = await fetch("https://<your-endpoint>/", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
  "id": 1,
  "method": "txpool_status",
  "params": [],
  "jsonrpc": "2.0"
}),
});
const data = await res.json();
import requests
resp = requests.post("https://<your-endpoint>/", json={"id":1,"method":"txpool_status","params":[],"jsonrpc":"2.0"})
print(resp.json())

Usage

  1. Transport: HTTP (JSON-RPC).
  2. Networks: mainnet.
  3. Credit cost: 1 per call.

FAQ

What does txpool_status do?
Returns the number of transactions currently pending and queued in the node's transaction pool, as hex-encoded integers.
How many credits does txpool_status cost?
txpool_status costs 1 credit(s) per call on Triport by default.
Is txpool_status available over WebSocket?
txpool_status is an HTTP JSON-RPC method.