getmempoolinfo

getmempoolinfo is a Bitcoin Core JSON-RPC method that returns a snapshot of the current state of the node's transaction mempool — the pool of unconfirmed BTC transactions waiting to be mined into a block. Because Bitcoin produces blocks roughly every ten minutes under Proof-of-Work, the mempool is where transactions queue between broadcast and confirmation, and its depth is a direct read on network congestion. The response reports loaded, size (the count of transactions), bytes, memory usage, the configured maxmempool, the mempoolminfee and minrelaytxfee fee floors, and several version-dependent fields such as total_fee, incrementalrelayfee, unbroadcastcount, and fullrbf. The method takes no parameters; send it to https://bitcoin.therpc.io/YOUR_API_KEY.

Use cases

• Read the current size (transaction count) and usage (memory consumed) to monitor how full the node's mempool is at any moment.
• Pull mempoolminfee to set a realistic fee floor for new BTC transactions — a transaction paying below this rate will not be accepted into the mempool.
• Gauge network congestion before broadcasting a payment, deciding whether to raise the fee rate or wait for the backlog to clear.

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": "getmempoolinfo",
8  "params": []
9}'

Errors & troubleshooting

Common pitfalls

• mempoolminfee and minrelaytxfee are reported in BTC per kvB, not sat/vB. Convert before fee math: multiply by 100,000,000 to get satoshis and divide by 1,000 to get a per-vB rate (so 0.00001000 BTC/kvB equals 1 sat/vB).
• Several fields are version-dependent — entries like total_fee, incrementalrelayfee, unbroadcastcount, and fullrbf were added in later Bitcoin Core releases and may be absent when the node runs an older version, so guard against missing keys.

Supported networks

• Mainnet
• Testnet

See also

• getrawmempool
• getmempoolentry
• estimatesmartfee