Documentation exported from Bitcoin Core 32.0

getmempoolancestors (32.0.0 RPC)

blockchain

control

mining

network

rawtransactions

signer

util

wallet

zmq

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)
  "hex",    (string) The transaction id of an in-mempool ancestor transaction
  ...
]

Result (for verbose = true):
{                                  (json object)
  "transactionid" : {              (json object)
    "vsize" : n,                   (numeric) (DEPRECATED) Was previously erroneously described as the BIP 141 vsize, but is actually sigops-adjusted vsize.
                                   Use vsize_bip141 to actually get that behavior or switch to the explicit vsize_adjusted for retained behavior.
    "vsize_bip141" : 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.
    "vsize_adjusted" : n,          (numeric) Maximum of sigop-adjusted size (-bytespersigop) and virtual transaction size as defined in BIP 141.
    "weight" : n,                  (numeric) transaction weight as defined in BIP 141.
    "time" : xxx,                  (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)
    "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)
    "chunkweight" : n,             (numeric) sigops-adjusted weight (as defined in BIP 141 and modified by '-bytespersigop') of this transaction's chunk
    "wtxid" : "hex",               (string) hash of serialized transaction, including witness data
    "fees" : {                     (json object)
      "base" : n,                  (numeric) transaction fee, denominated in BTC
      "modified" : n,              (numeric) transaction fee with fee deltas used for mining priority, denominated in BTC
      "ancestor" : n,              (numeric) transaction fees of in-mempool ancestors (including this one) with fee deltas used for mining priority, denominated in BTC
      "descendant" : n,            (numeric) transaction fees of in-mempool descendants (including this one) with fee deltas used for mining priority, denominated in BTC
      "chunk" : n                  (numeric) transaction fees of chunk, denominated in BTC
    },
    "depends" : [                  (json array) unconfirmed transactions used as inputs for this transaction
      "hex",                       (string) parent transaction id
      ...
    ],
    "spentby" : [                  (json array) unconfirmed transactions spending outputs from this transaction
      "hex",                       (string) child transaction id
      ...
    ],
    "unbroadcast" : true|false     (boolean) Whether this transaction is currently unbroadcast (initial broadcast not yet acknowledged by any peers)
  },
  ...
}

Examples:
> bitcoin-cli getmempoolancestors "mytxid"
> curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "getmempoolancestors", "params": ["mytxid"]}' -H 'content-type: application/json' http://127.0.0.1:8332/