TriportRPC
DashboardDocs

txpool_status

POSThttps://triport.io/rpc/bsc

Return pending and queued transaction counts.

BNB Smart Chainbsc:rpcbsc_read_rpc - 15 / 20 / 100 / 250 RPS (free / basic / pro / business) (default, unmeasured); enterprise unlimited

txpool_status returns pending and queued transaction counts from the selected BNB Smart Chain node's txpool.

Both counters are EVM hex quantities. Use it for a lightweight txpool size signal when individual pending transactions are not required.

Use txpool_content for full transaction objects or txpool_inspect for compact entry summaries. The view is observational and node-local; Triport does not expose BSC transaction submission.

Parameters

JSON-RPC params must be an empty array: [].

Response

The response below is the checked fixture for this method; it is reproduced without changing its fields or values.

resultobject
Selected node's txpool counters.
result.pendingstring
Pending transaction count as a hex quantity.
result.queuedstring
Queued transaction count as a hex quantity.

Errors

Errors use the standard JSON-RPC error envelope. See BSC errors for network-specific classification and the linked shared reference.

CodeMeaningWhen it happens
-32602Invalid paramsA required positional parameter is missing or a value does not match the OpenRPC schema.
401UnauthorizedThe x-token API key is missing or invalid.
429Rate limitedThe request exceeds the configured category RPS for the caller's tier.

Examples

JavaScript (fetch)

const response = await fetch("https://triport.io/rpc/bsc", {
  method: "POST",
  headers: {
    "x-token": process.env.TRIPORT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "txpool_status",
    "params": []
  }),
});


const payload = await response.json();
console.log(payload.result);

Notes

  • The counters belong to the selected upstream node and are not a canonical or pool-wide mempool total.
  • The BSC categories use configured defaults of 15 / 20 / 100 / 250 RPS; they are marked unmeasured in the tier matrix.
  • Related methods: txpool_content, txpool_inspect, eth_getTransactionCount.