Skip to main content

getmempooldescendants RPC Method

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

Updated on
Feb 03, 2026

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
Response
1
{
2
"result": {
3
"locked": {
4
"used": 1872,
5
"free": 260272,
6
"total": 262144,
7
"locked": 262144,
8
"chunks_used": 52,
9
"chunks_free": 7
10
}
11
},
12
"error": null,
13
"id": null
14
}
1
{
2
"result": {
3
"locked": {
4
"used": 1872,
5
"free": 260272,
6
"total": 262144,
7
"locked": 262144,
8
"chunks_used": 52,
9
"chunks_free": 7
10
}
11
},
12
"error": null,
13
"id": null
14
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free