Documentation exported from Bitcoin Core 0.17.99

listtransactions (0.17.99 RPC)

blockchain

control

generating

mining

network

rawtransactions

util

wallet

listtransactions (dummy count skip include_watchonly)

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

Arguments

1. "dummy"

string

optional

If set, should be “*” for backwards compatibility.

2. count

numeric

optional

default=10

The number of transactions to return

3. skip

numeric

optional

default=0

The number of transactions to skip

4. include_watchonly

bool

optional

default=false

Include transactions to watch-only addresses (see ‘importaddress’)

Result

[
  {
    "address":"address",

string

The bitcoin address of the transaction.

    "category":"send|receive",

string

The transaction category.

    "amount": x.xxx,

numeric

The amount in BTC. This is negative for the ‘send’ category, and is positive for the ‘receive’ category,

    "label": "label",

string

A comment for the address/transaction, if any

    "vout": n,

numeric

the vout value

    "fee": x.xxx,

numeric

The amount of the fee in BTC. This is negative and only available for the ‘send’ category of transactions.

    "confirmations": n,

numeric

The number of confirmations for the transaction. Negative confirmations indicate the transaction conflicts with the block chain

    "trusted": xxx,

bool

Whether we consider the outputs of this unconfirmed transaction safe to spend.

    "blockhash": "hashvalue",

string

The block hash containing the transaction.

    "blockindex": n,

numeric

The index of the transaction in the block that includes it.

    "blocktime": xxx,

numeric

The block time in seconds since epoch (1 Jan 1970 GMT).

    "txid": "transactionid",

string

The transaction id.

    "time": xxx,

numeric

The transaction time in seconds since epoch (midnight Jan 1 1970 GMT).

    "timereceived": xxx,

numeric

The time received in seconds since epoch (midnight Jan 1 1970 GMT).

    "comment": "...",

string

If a comment is associated with the transaction.

    "bip125-replaceable": "yes|no|unknown",

string

Whether this transaction could be replaced due to BIP125 (replace-by-fee); may be unknown for unconfirmed transactions not in the mempool

    "abandoned": xxx

bool

‘true’ if the transaction has been abandoned (inputs are respendable). Only available for the ‘send’ category of transactions.

  }
]

Examples

List the most recent 10 transactions in the systems

bitcoin-cli listtransactions 

List transactions 100 to 120

bitcoin-cli listtransactions "*" 20 100

As a json rpc call

curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listtransactions", "params": ["*", 20, 100] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/