Skip to main content

getmempoolancestors RPC Method

Returns all in-mempool ancestors for a transaction in the mempool.

Updated on
Oct 4, 2023

getmempoolancestors RPC Method

Parameters

txid
string
REQUIRED
The transaction id, and it must be in mempool
verbose
boolean
default=false. It's true for a JSON object and false for array of transaction ids

Returns

(for verbose = false)
hex
The transaction id of an in-mempool ancestor transaction
(for verbose = true)
transactionid
The transaction id
vsize
The virtual transaction size as defined in BIP 141. This is different from actual serialized size for witness transactions as witness data is discounted
weight
The transaction weight as defined in BIP 141
time
The local time transaction entered pool in seconds since 1 Jan 1970 GMT
height
The block height when the transaction entered pool
descendantcount
The number of in-mempool descendant transactions (including this one)
descendantsize
The virtual transaction size of in-mempool descendants (including this one)
ancestorcount
The number of in-mempool ancestor transactions (including this one)
ancestorsize
The virtual transaction size of in-mempool ancestors (including this one)
wtxid
The hash of serialized transaction, including witness data
fees
A JSON array containing information about the transaction fee paid by the transaction
base
The transaction fee in BTC
modified
The transaction fee with fee deltas used for mining priority in BTC
ancestor
The modified fees of in-mempool ancestors (including this one) in BTC
descendant
The modified fees of in-mempool descendants (including this one) in BTC
depends
Unconfirmed transactions used as inputs for this transaction
hex
The parent transaction id
spentby
Unconfirmed transactions spending outputs from this transaction
hex
The child transaction id
bip125-replaceable
Whether this transaction could be replaced due to BIP125 (replace-by-fee)
unbroadcast
Whether this transaction is currently unbroadcast (initial broadcast not yet acknowledged by any peers)
Request
1
curl https://docs-demo.btc.quiknode.pro/ \
2
-X POST \
3
-H "Content-Type: application/json" \
4
--data '{"method": "getmempoolancestors", "params": ["txid"]}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free