getrawmempool

getrawmempool is a Bitcoin Core JSON-RPC method that lists the transaction ids of every unconfirmed BTC transaction currently held in the node's mempool — the full set of payments waiting for a Proof-of-Work miner to include them in a block. Send the request to https://bitcoin.therpc.io/YOUR_API_KEY using positional params. By default it returns a flat array of txid strings, which is the lightest way to enumerate the pool. Pass verbose = true to instead receive an object keyed by txid, where each value carries per-transaction detail such as vsize, weight, time, the fees object (in BTC), depends and spentby links, ancestor and descendant counts, and the bip125-replaceable flag.

Use cases

• Enumerate the unconfirmed txids in the pool and watch for a specific payment to appear, confirming that a broadcast BTC transaction has been accepted by the network.
• Pull per-transaction fee and ancestry data with verbose = true to drive fee-bumping decisions such as CPFP or RBF without a separate getmempoolentry call per transaction.
• Take a periodic snapshot of mempool contents to feed a block explorer, a fee-estimation dashboard, or a congestion monitor.

Parameters

Response

Example request

1curl https://bitcoin.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "1.0",
6  "id": "therpc",
7  "method": "getrawmempool",
8  "params": [
9    false,
10    false
11  ]
12}'

Errors & troubleshooting

Common pitfalls

• verbose = true builds a full detail object for every transaction in the pool, which can be a heavy response when the mempool holds tens of thousands of entries. Prefer the plain txid array and fetch detail only for the txids you actually need.
• The mempool_sequence option cannot be combined with verbose = true; requesting both at once is rejected. Use mempool_sequence only with the plain (non-verbose) txid list.

Supported networks

• Mainnet
• Testnet

See also

• getmempoolentry
• getmempoolinfo
• getmempoolancestors