txpool_status

txpool_status returns just two numbers about a Polygon PoS node's transaction pool: the count of pending transactions (ready to be included in a block) and the count of queued transactions (waiting on a nonce gap or other condition), both hex-encoded. It is the lightweight counterpart to txpool_inspect — perfect for a fast read of mempool depth on a low-fee, ~2-second-block network where backlog can shift quickly. Call it against the Polygon mainnet endpoint at https://polygon.therpc.io/YOUR_API_KEY (chain ID 137, 0x89).

Use cases

• Monitor Polygon mempool depth to detect congestion and raise the gas price on outgoing MATIC transactions when the pending count spikes.
• Feed a dashboard gauge showing the current Polygon transaction backlog, polling the cheap pending and queued counts on a short interval.

Parameters

Cette méthode ne prend aucun paramètre. Passez un tableau vide [].

Response

Example request

1curl https://polygon.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "txpool_status",
7    "params": [],
8    "id": 1
9  }'

Try it live in the Polygon playground.

Errors & troubleshooting

Common pitfalls

• The txpool namespace comes from the Geth family. Polygon's Bor client is Geth-based so it is usually present, but some managed endpoints disable it — be ready for a "method not found" response.
• The counts are point-in-time snapshots and change very fast on Polygon's ~2-second blocks; do not cache them aggressively or you will display stale backlog figures.

Supported networks

• Mainnet — Chain ID: 137
• Amoy — Chain ID: 80002

See also

• txpool_inspect

1curl https://polygon.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"txpool_status","params":[]}'