PREMIUM ADD-ON ✨Real-time usage is available on Lago Cloud upon request only. Please contact us to enable it for your organization.

What changes for you
Stop serving unpaid usage
Balances drop as usage happens. Your product sees a wallet run dry before it goes deep into negative.
Show balances customers trust
The balance in your customer-facing UI matches what they just consumed. Fewer billing tickets, fewer surprises on the invoice.
Warn before budgets break
Wallet alerts fire seconds after a balance crosses a threshold, while there is still time to top up or slow down.
How it works
1
You send events
Send usage events the same way you do today, through the API or any supported connector. Nothing changes in your integration.
2
Lago aggregates usage as events stream in
Usage is aggregated continuously per subscription, charge and charge filter, instead of being recomputed from raw events on each refresh.
3
The ongoing balance refreshes
The wallet’s ongoing balance reflects the event from under a second to a few seconds later. A burst of events collapses into a single refresh, so the balance stays current under load.
4
Alerts are evaluated right away
As soon as a balance moves, Lago evaluates your wallet alerts and sends
alert.triggered when a threshold is crossed.5
Your product acts
Your app reads the balance or reacts to the webhook, then tops up, throttles or blocks. Lago supplies the state. Enforcement stays in your request path.
The ongoing balance is not a spending cap. Two concurrent requests can read the same balance and both proceed, and the balance can go below zero. To enforce a hard limit, authorize the work in your application before it starts.
Capabilities
Real-time wallet balance
The ongoing balance of every wallet tied to a covered charge refreshes from under a second to a few seconds after an event, instead of on the periodic cycle. Read it in the dashboard, or through the API:Retrieve a wallet
ongoing_balance_cents and credits_ongoing_balance carry the refreshed values. Automatic top-ups triggered by a threshold monitor the same ongoing balance, so they also react within seconds.
Real-time wallet alerts
Wallet alerts are evaluated as soon as the ongoing balance moves, instead of waiting for the next periodic check. Usage alerts keep their periodic check.- A burst of events triggers a single alert, not one per event.
- Alerts and webhooks keep the same payloads, thresholds and resolution rules. Your webhook handlers need no change.
Real-time current usage
Current usage for a subscription is served from the continuously aggregated data. The amounts you show your customers in a usage page match the events they just sent.Real-time usage graph and report
The usage page in the Lago app reads the same continuously aggregated data. Its graph and report per billable metric update as events arrive, so your teams see the numbers your product acts on, for example tokens per model during a traffic spike. Metrics outside the coverage, recurring metrics included, do not appear on this page.Coverage
Real-time refresh applies to charges whose billable metric uses one of these aggregations:
A charge is refreshed in real time when it also meets these conditions:
Other charges keep the periodic refresh. Their events are billed exactly as before. Only the refresh delay differs.
Reliability
- Same invoice. The add-on changes how fast balances refresh, not how invoices are computed. Invoices are still produced from the full event store.
- Automatic fallback. If the real-time path is delayed, the periodic refresh takes over. No event is dropped and no balance is skipped.
- No integration change. Events, endpoints, webhooks and payloads stay the same. Turning the add-on on or off requires no code change on your side.
Get started
- Contact us with the organization you want to enable. We recommend starting on a sandbox organization.
- Create a wallet with a credits consumption alert on its ongoing balance.
- Send events and watch the ongoing balance and the
alert.triggeredwebhook follow them.