listtransactions

Back to wallet

Wallet

Summary

If a label name is provided, this will return only incoming transactions paying to addresses with the specified label.

Description

If a label name is provided, this will return only incoming transactions paying to addresses with the specified label.

Returns up to 'count' most recent transactions skipping the first 'from' transactions.

Arguments

  • label (STR): If set, should be a valid label name to return only incoming transactions with the specified label, or "*" to disable filtering and return all transactions.
  • count (NUM): The number of transactions to return
  • skip (NUM): The number of transactions to skip
  • include_watchonly (BOOL): (DEPRECATED) No longer used

Results

  • value (ARR): No description.
  • value (OBJ): No description.
    • address (STR, optional): The qbit address of the transaction (not returned if the output does not have an address, e.g. OP_RETURN null data).
    • category (STR): The transaction category. "send" Transactions sent. "receive" Non-coinbase transactions received. "generate" Coinbase transactions received with more than 100 confirmations. "immature" Coinbase transactions received with 100 or fewer confirmations. "orphan" Orphaned coinbase transactions received.
    • amount (STR_AMOUNT): The amount in QBT. This is negative for the 'send' category, and is positive for all other categories
    • label (STR, optional): A comment for the address/transaction, if any
    • vout (NUM): the vout value
    • fee (STR_AMOUNT, optional): The amount of the fee in QBT. This is negative and only available for the 'send' category of transactions.
    • confirmations (NUM): The number of confirmations for the transaction. Negative confirmations means the transaction conflicted that many blocks ago.
    • generated (BOOL, optional): Only present if the transaction's only input is a coinbase one.
    • trusted (BOOL, optional): Whether we consider the transaction to be trusted and safe to spend from. Only present when the transaction has 0 confirmations (or negative confirmations, if conflicted).
    • blockhash (STR_HEX, optional): The block hash containing the transaction.
    • blockheight (NUM, optional): The block height containing the transaction.
    • blockindex (NUM, optional): The index of the transaction in the block that includes it.
    • blocktime (NUM_TIME, optional): The block time expressed in UNIX epoch time.
    • txid (STR_HEX): The transaction id.
    • wtxid (STR_HEX): The hash of serialized transaction, including witness data.
    • walletconflicts (ARR): Confirmed transactions that have been detected by the wallet to conflict with this transaction.
    • txid (STR_HEX): The transaction id.
    • replaced_by_txid (STR_HEX, optional): Only if 'category' is 'send'. The txid if this tx was replaced.
    • replaces_txid (STR_HEX, optional): Only if 'category' is 'send'. The txid if this tx replaces another.
    • mempoolconflicts (ARR): Transactions in the mempool that directly conflict with either this transaction or an ancestor transaction
    • txid (STR_HEX): The transaction id.
    • to (STR, optional): If a comment to is associated with the transaction.
    • time (NUM_TIME): The transaction time expressed in UNIX epoch time.
    • timereceived (NUM_TIME): The time received expressed in UNIX epoch time.
    • comment (STR, optional): If a comment is associated with the transaction, only present if not empty.
    • bip125-replaceable (STR): ("yes|no|unknown") Whether this transaction signals BIP125 replaceability or has an unconfirmed ancestor signaling BIP125 replaceability. May be unknown for unconfirmed transactions not in the mempool because their unconfirmed ancestors are unknown.
    • parent_descs (ARR, optional): Only if 'category' is 'received'. List of parent descriptors for the output script of this coin.
    • desc (STR): The descriptor string.
    • abandoned (BOOL): 'true' if the transaction has been abandoned (inputs are respendable).

Examples

List the most recent 10 transactions in the systems

qbit-cli listtransactions

List transactions 100 to 120

qbit-cli listtransactions "*" 20 100

As a JSON-RPC call

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "listtransactions", "params": ["*", 20, 100]}' -H 'content-type: application/json' http://127.0.0.1:8352/