Skip to main content

getmempooldescendants RPC Method

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

Updated on
Feb 04, 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)
array

When verbose is false (the default), result is an array of transaction ids for in-mempool descendant transactions.

result
string

The transaction id of an in-mempool ancestor transaction

(for verbose = true)
object

When verbose is true, result is a JSON object mapping each descendant transaction id to its detailed transaction data.

transactionid
object

The transaction id

vsize
integer

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
integer

The transaction weight as defined in BIP 141

time
integer

The local time transaction entered pool in seconds since 1 Jan 1970 GMT

height
integer

The block height when the transaction entered pool

descendantcount
integer

The number of in-mempool descendant transactions (including this one)

descendantsize
integer

The virtual transaction size of in-mempool descendants (including this one)

ancestorcount
integer

The number of in-mempool ancestor transactions (including this one)

ancestorsize
integer

The virtual transaction size of in-mempool ancestors (including this one)

wtxid
string

The hash of serialized transaction, including witness data

fees
object

A JSON array containing information about the transaction fee paid by the transaction

base
number

The transaction fee in BTC

modified
number

The transaction fee with fee deltas used for mining priority in BTC

ancestor
number

The modified fees of in-mempool ancestors (including this one) in BTC

descendant
number

The modified fees of in-mempool descendants (including this one) in BTC

depends
array

Unconfirmed transactions used as inputs for this transaction

hex
string

The parent transaction id

spentby
array

Unconfirmed transactions spending outputs from this transaction

hex
string

The child transaction id

bip125-replaceable
boolean

Whether this transaction could be replaced due to BIP125 (replace-by-fee)

unbroadcast
boolean

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