Documentation exported from Bitcoin Core 0.17.99

getmempoolancestors (0.17.99 RPC)

blockchain

control

generating

mining

network

rawtransactions

util

wallet

getmempoolancestors txid (verbose)

If txid is in the mempool, returns all in-mempool ancestors.

Arguments

1. "txid"

string

required

The transaction id (must be in mempool)

2. verbose

boolean

optional

default=false

True for a json object, false for array of transaction ids

Result (for verbose=false)

[

json array of strings

  "transactionid"

string

The transaction id of an in-mempool ancestor transaction

  ,...
]

Result (for verbose=true)

{

json object

  "transactionid" : {

json object

    "size" : n,

numeric

virtual transaction size as defined in BIP 141. This is different from actual serialized size for witness transactions as witness data is discounted.

    "fee" : n,

numeric

transaction fee in BTC (DEPRECATED)

    "modifiedfee" : n,

numeric

transaction fee with fee deltas used for mining priority (DEPRECATED)

    "time" : n,

numeric

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

    "height" : n,

numeric

block height when transaction entered pool

    "descendantcount" : n,

numeric

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

    "descendantsize" : n,

numeric

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

    "descendantfees" : n,

numeric

modified fees (see above) of in-mempool descendants (including this one) (DEPRECATED)

    "ancestorcount" : n,

numeric

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

    "ancestorsize" : n,

numeric

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

    "ancestorfees" : n,

numeric

modified fees (see above) of in-mempool ancestors (including this one) (DEPRECATED)

    "wtxid" : hash,

string

hash of serialized transaction, including witness data

    "fees" : {
        "base" : n,

numeric

transaction fee in BTC

        "modified" : n,

numeric

transaction fee with fee deltas used for mining priority in BTC

        "ancestor" : n,

numeric

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

        "descendant" : n,

numeric

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

    }
    "depends" : [

array

unconfirmed transactions used as inputs for this transaction

        "transactionid",

string

parent transaction id

       ... ]
    "spentby" : [

array

unconfirmed transactions spending outputs from this transaction

        "transactionid",

string

child transaction id

       ... ]
    "bip125-replaceable" : true|false,

boolean

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

  }, ...
}

Examples

Examples:

bitcoin-cli getmempoolancestors "mytxid"
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmempoolancestors", "params": ["mytxid"] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/