listsinceblock

listsinceblock ( "blockhash" target_confirmations include_watchonly include_removed )

Returns all transactions in blocks since the specified block hash, or all transactions if omitted.

If the specified blockhash is no longer part of the main chain, transactions from the fork point onward are included.

If include_removed is set to true, transactions affecting the wallet that were removed due to a reorg will be returned in the “removed” array.

Argument #1 – blockhash

Type: string, optional

Specifies the block hash from which to list transactions. If omitted, all transactions will be listed.

Argument #2 – target_confirmations

Type: numeric, optional, default=1

Returns the nth block hash from the main chain. For example, 1 would return the best block hash. This is not used as a filter but only affects the lastblock in the return value.

Argument #3 – include_watchonly

Type: boolean, optional, default=true for watch-only wallets, otherwise false

Includes transactions to watch-only addresses (see importaddress).

Argument #4 – include_removed

Type: boolean, optional, default=true

Includes transactions that were removed due to a reorganization in the “removed” array (not guaranteed to work on pruned nodes).

Result

{                                          (json object)
  "transactions" : [                       (json array)
    {                                      (json object)
      "involvesWatchonly" : true|false,    (boolean) Only returns true if imported addresses were involved in transaction.
      "address" : "str",                   (string) The bitcoinevo address of the transaction.
      "category" : "str",                  (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" : n,                        (numeric) The amount in BTCE. This is negative for the 'send' category, and is positive
                                           for all other categories
      "vout" : n,                          (numeric) the vout value
      "fee" : n,                           (numeric) The amount of the fee in BTCE. This is negative and only available for the
                                           'send' category of transactions.
      "confirmations" : n,                 (numeric) The number of confirmations for the transaction. Negative confirmations means the
                                           transaction conflicted that many blocks ago.
      "generated" : true|false,            (boolean) Only present if transaction only input is a coinbase one.
      "trusted" : true|false,              (boolean) Only present if we consider transaction to be trusted and so safe to spend from.
      "blockhash" : "hex",                 (string) The block hash containing the transaction.
      "blockheight" : n,                   (numeric) The block height containing the transaction.
      "blockindex" : n,                    (numeric) The index of the transaction in the block that includes it.
      "blocktime" : xxx,                   (numeric) The block time expressed in UNIX epoch time.
      "txid" : "hex",                      (string) The transaction id.
      "walletconflicts" : [                (json array) Conflicting transaction ids.
        "hex",                             (string) The transaction id.
        ...
      ],
      "time" : xxx,                        (numeric) The transaction time expressed in UNIX epoch time.
      "timereceived" : xxx,                (numeric) The time received expressed in UNIX epoch time.
      "comment" : "str",                   (string) If a comment is associated with the transaction, only present if not empty.
      "bip125-replaceable" : "str",        (string) ("yes|no|unknown") Whether this transaction could be replaced due to BIP125 (replace-by-fee);
                                           may be unknown for unconfirmed transactions not in the mempool
      "abandoned" : true|false,            (boolean) 'true' if the transaction has been abandoned (inputs are respendable). Only available for the
                                           'send' category of transactions.
      "label" : "str",                     (string) A comment for the address/transaction, if any
      "to" : "str"                         (string) If a comment to is associated with the transaction.
    },
    ...
  ],
  "removed" : [                            (json array) <structure is the same as "transactions" above, only present if include_removed=true>
                                           Note: transactions that were re-added in the active chain will appear as-is in this array, and may thus have a positive confirmation count.
    ...
  ],
  "lastblock" : "hex"                      (string) The hash of the block (target_confirmations-1) from the best block on the main chain, or the genesis hash if the referenced block does not exist yet. This is typically used to feed back into listsinceblock the next time you call it. So you would generally use a target_confirmations of say 6, so you will be continually re-notified of transactions until they've reached 6 confirmations plus any new ones
}

Examples

bitcoinevo-cli listsinceblock
bitcoinevo-cli listsinceblock "000000000fd8a46030b5f130cb3b4d243171264918c3188562103cf1b0c48861" 6
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "listsinceblock", "params": ["000000000fd8a46030b5f130cb3b4d243171264918c3188562103cf1b0c48861", 6]}' -H 'content-type: text/plain;' http://127.0.0.1:7332/