Trace a channel balance adjustment with Core Lightning Bookkeeper

A dashboard balance change can come from channel activity, chain settlement or an onchain fee update. Query the channel's bookkeeping account to see the movement type.

Select the channel account

With the Bookkeeper plugin available, set CHANNEL_ID to the channel's full ID. Inspect debit and credit separately. The timestamp is when the event was recorded by the node.

lightning-cli bkpr-listaccountevents "$CHANNEL_ID" | jq '.events[] | {timestamp, type, tag, credit_msat, debit_msat, blockheight, txid}'

Explain the direction of change

A credit increases the selected account and a debit reduces it. For chain events, check the reported block height before assigning a settlement date. Consolidated onchain fees can be updated as further spend information arrives, so retain the transaction context when reconciling successive exports.

docs.corelightning.org bkpr-listaccountevents