listchannelmoves -- Command to get the audit list of all channel coin movements.
SYNOPSIS
listchannelmoves [index [start] [limit]]
DESCRIPTION
Command added in v25.09.
The listchannelmoves command returns the confirmed balance changes within lightning channels over time.
- index (string, optional) (always "created"): How to interpret
start
andlimit
- 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 channelmoves 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): The channel_id corresponding to the channel involved.
- 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 "invoice", "routed", "pushed", "lease_fee", "channel_proposed", "penalty_adj", "journal_entry"): A set of one or more tags defining the nature of the change
- fees_msat (msat): The fees paid for this payment
- payment_hash (hash, optional): The hash associated with this payment (not present for leases or push funding)
- part_id (u64, optional): The part_id for the payment (the
payment_hash
,group_id
,part_id
tuple will be unique) - group_id (u64, optional): The group_id for the payment (the
payment_hash
,group_id
,part_id
tuple will be unique)
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