About these signals: Optaimaze currently measures historical candidate rankings, not payment success probability or independent node reliability. Read methodology and coverage →

← Why Lightning payments fail

Lightning error guide

Insufficient balance and liquidity: the most common reason Lightning payments fail

Last updated:

Liquidity errors show up in a few different forms. Your own node might report insufficient_balance (LND's FAILURE_REASON_INSUFFICIENT_BALANCE) or "insufficient local balance". A node partway along the route might return temporary_channel_failure. And when liquidity is the hidden cause behind a failed search, many wallets just say "insufficient liquidity" or "route not found".

They all point to the same fact. Lightning channels hold a fixed amount of bitcoin split between two parties, and a payment can only move through a channel in a direction where enough of that balance sits on the sending side.

Live data

Live Lightning routing signal

Reliability signal100/100
SignalStrong historical signal
Risk levelLow
Top-ranked nodeACINQ
Last snapshotNov 22, 2026 20:56 UTC

This is a historical ranking proxy built from observed route candidates over the last 24 hours. It is not a payment success probability and does not measure directional liquidity for your specific path.

Check current routing reliability on the dashboard →

Outbound vs. inbound liquidity

Every channel has two sides. Outbound liquidity is the balance on your side, which you can send. Inbound liquidity is the balance on your peer's side, which is how much you can receive. If you open a 1,000,000 sat channel, you start with roughly 1,000,000 sats outbound and close to zero inbound. You can pay right away but cannot receive until some balance moves to the other side.

The same applies at every hop. A route works only if each channel along it has enough balance on the forwarding side for the amount plus the fees added by later hops. Public gossip announces each channel's total capacity, not how it is split, so senders have to discover this by trying.

Where the error comes from

1. Your own channels: "insufficient balance"

Your node checks its own channels first. Even if your wallet balance looks large enough, the spendable amount is lower than the total because:

2. A channel along the route: temporary_channel_failure

BOLT 4 defines temporary_channel_failure as a forwarding node saying its outgoing channel could not handle this HTLC right now but might later. The usual cause is not enough balance in that direction. It can also mean the channel hit its limit on pending HTLCs or in-flight value, or that the next peer is briefly unavailable. Your node records the failure, avoids that channel for a while, and tries another path.

3. The recipient: no inbound capacity

If the recipient's channels hold almost nothing on the remote side, every path dies at the last hop. Senders usually see this as repeated temporary failures followed by "no route found". It is very common with newly opened nodes and self-custodial wallets.

Fixes for senders

  1. Check your spendable balance, not your total balance. Most node software reports both, for example lncli channelbalance or listfunds in Core Lightning.
  2. Send less or split the payment. Use MPP if your wallet supports it, or send two smaller payments if the recipient agrees.
  3. Retry after a short wait. Liquidity shifts constantly as other payments flow through the network.
  4. If you control both ends, consider opening a direct channel to the recipient or a well-connected peer close to them.

Fixes for receivers and node operators

Watching liquidity risk over time

Individual balances are private, so nobody outside a channel can see them directly. What you can watch is behavior over time: whether the same routing candidates keep ranking well, how often leadership changes, and how volatile scores are. The Optaimaze dashboard summarizes those historical signals. Treat them as context for your own node's payment logs, not as a liquidity measurement.

Error guides

Lightning payment error guides

FAQ

Insufficient balance and liquidity FAQ

Why does my Lightning wallet say insufficient balance when I have enough funds?

Spendable Lightning balance is lower than your total. Channel reserves (often around 1% of capacity), commitment transaction fees, anchor reserves, and routing fees all reduce it, and without multi-path payments one channel may need to carry the whole amount.

What is temporary_channel_failure on Lightning?

It is a BOLT 4 error a forwarding node returns when its outgoing channel cannot handle the payment right now. The most common cause is not enough balance in that direction, but HTLC count or in-flight value limits and short peer outages can also trigger it. The sender usually tries another path automatically.

Why can I send but not receive Lightning payments?

You probably have outbound liquidity but little inbound liquidity. A channel you open starts with the balance on your side. To receive, you need capacity on the remote side, from an inbound channel, a Lightning Service Provider, a liquidity marketplace, or a swap.

How do I fix insufficient liquidity errors as a node operator?

Add inbound capacity, rebalance channels that drain in one direction when the cost is justified, set directional fees that reflect scarcity, and log failures by channel so you can see which peers repeatedly fail to forward.

Can Optaimaze show me channel balances?

No. Channel balances are private. Optaimaze publishes historical ranking signals about observed route candidates, which give context about routing stability but do not measure the liquidity of any specific channel or path.

Live reliability signal

Check current routing reliability.

See current top-ranked route candidates, leadership changes, volatility, and risk level from recent snapshots.

Open Insights