TriportRPC
DashboardDocs

txpool_status

Polygon / https://triport.io/polygon

Minimum tier: Free

Polygon method guide

Last updated:

txpool_status returns the number of transactions currently held in the node's mempool, split into two buckets: pending (transactions that are executable right now — the account nonce and balance allow them to be included in the next block) and queued (transactions that are not yet executable, usually because of a nonce gap). The result is counts only — no transaction hashes, senders, or calldata are included.

This is the lightest of the three mempool snapshot methods: a typical response is around 30 bytes, so it is well suited to frequent polling (every 1–5 seconds) when you want to track pool depth or detect congestion in near real time. Use it as the cheap health-check signal, and reach for the heavier txpool_content on a slower cadence (every ~30–60 seconds) only when you actually need the full transaction bodies.

txpool_status is a premium capability and requires the Pro tier or higher. It is not part of the free read-RPC namespace.

Parameters

This method takes no parameters.

Returns

txpool_status return value
FieldType
resultobject

Examples

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

Usage

  1. Transport: HTTP (JSON-RPC).
  2. Chain: Polygon.
  3. Clusters: mainnet.
  4. Credit cost: 1 per call.

FAQ

What does txpool_status do?
Returns the current depth of the Polygon mempool as two integer counts — pending and queued transactions — without any transaction bodies.
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.