listchainmoves -- Command to get the audit list of all onchain coin movements.

SYNOPSIS

listchainmoves [index [start] [limit]]

DESCRIPTION

Command added in v25.09.

The listchainmoves command returns the confirmed balance changes onchain over time.

• index (string, optional) (always "created"): How to interpret start and limit
• start (u64, optional): If index is specified, start may be specified to start from that value, which is generally returned from lightning-wait(7).
• limit (u32, optional): If index is specified, limit can be used to specify the maximum number of entries to return.

RETURN VALUE

On success, an object containing chainmoves is returned. It is an array of objects, where each object contains:

• created_index (u64): 1-based index indicating order this move was created in.
• account_id (string): This is either the channel_id corresponding to the channel involved, or a string such as wallet for the internal wallet, or external for some other external source.
• credit_msat (msat): Amount credited (one of this or debit_msat is zero)
• debit_msat (msat): Amount debited (one of this or credit_msat is zero)
• timestamp (u64): Time of this event in seconds since January 1 1970 UTC
• primary_tag (string) (one of "deposit", "withdrawal", "penalty", "channel_open", "channel_close", "delayed_to_us", "htlc_tx", "htlc_timeout", "htlc_fulfill", "to_wallet", "anchor", "to_them", "penalized", "stolen", "ignored", "to_miner"): A set of one or more tags defining the nature of the change
• extra_tags (array of strings): A set of additional tags expanding on the details:
  • (string, optional) (one of "opener", "leased", "stealable", "splice", "foreign")
• utxo (outpoint): The txid and outpoint number spent for this balance change.
• output_msat (msat): The output amount (always a whole number of sats). Note that in some cases (e.g. channel opens), not all these belong to us.
• blockheight (u32): The block number where txid appeared (alternately, where utxo was spent).
• peer_id (pubkey, optional): The lightning peer associated with this onchain event
• originating_account (string, optional): This is either a channel_id corresponding to the source channel involved, or a string such as wallet for the internal wallet.
• spending_txid (txid, optional): The transaction ID which did the spending.
• payment_hash (hash, optional): The payment hash associated with this balance change.
• output_count (u32, optional): The number of outputs in the txid (so you can tell once you've seen events for all of them).

ERRORS

On failure, one of the following error codes may be returned:

• -32602: Error in given parameters.

RESOURCES

Main web site: https://github.com/ElementsProject/lightning