.. This file is licensed under the MIT License (MIT) available on
   http://opensource.org/licenses/MIT.

listtransactions
================

``listtransactions ( "label" count skip include_watchonly )``

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.

Argument #1 - label
~~~~~~~~~~~~~~~~~~~

**Type:** string, optional

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.

Argument #2 - count
~~~~~~~~~~~~~~~~~~~

**Type:** numeric, optional, default=10

The number of transactions to return

Argument #3 - skip
~~~~~~~~~~~~~~~~~~

**Type:** numeric, optional, default=0

The number of transactions to skip

Argument #4 - include_watchonly
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Type:** boolean, optional, default=false

Include transactions to watch-only addresses (see 'importaddress')

Result
~~~~~~

::

  [
    {
      "address":"address",    (string) The bitcoin address of the transaction.
      "category":               (string) 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": x.xxx,          (numeric) The amount in BTC. This is negative for the 'send' category, and is positive
                                          for all other categories
      "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
~~~~~~~~


.. highlight:: shell

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/