SCF Applying to the Stellar Community Fund? Get a free account with higher usage limits. Claim the offer →
Activity APIAssets APIWebhooksRPC
Webhooks

Know the moment
money moves.

Signed alerts to your server, a few seconds after it happens on Stellar.

Start free Read the docs
Prefer an AI assistant? Set up with your agent →
Secondsfrom event to alertSignedevery single alert5 minutesto your first alert
Your serverapi.your-app.com/alertsReceiving
Webhooks · FiltersWatchingAlex’s walletPaymentsBalance changes
Webhooks · Signed alertsAlertsIn order
Payment received480 USDC from Sam✓ Signedjust now
Balance changedAlex’s USDC is now 8,572.30✓ Signedjust now
Payment received120 EURC · arrived on a retry✓ Signed2 min ago
App actionAlex swapped 50 XLM for USDC✓ Signed6 min ago
Webhooks · CoverageNothing missed today100% covered09:0012:00Now
Outlined parts come straight from Lumeus Webhooks
Why alerts are hard on Stellar

Five things you’d have to build without Webhooks.

To react to payments yourself, you’d watch the network around the clock, decode what you see, prove it’s genuine and make sure nothing slips through while your server is down.

01 / 05

Stellar never calls your server.

On your ownTo hear about a payment, your server has to keep asking the network, again and again, and still finds out late.
With WebhooksLumeus calls your server when something you care about happens, a few seconds after it lands on Stellar.
Your server · checking for newsWithout Lumeus
Requests sent today17,280One every 5 seconds, just in case
10:00:00CheckedNothing new—
10:00:05CheckedNothing new—
10:00:10CheckedNothing new—
10:00:40Payment foundNoticed on a later check+480 USDC
Constant checking, late news
Your server · incomingWith Lumeus
Requests sent today0Lumeus calls you instead
Webhooks · Push alerts
Payment received480 USDC from Sam · seconds after it happened+480 USDC
Balance changedAlex’s USDC is now 8,572.308,572.30
Told within seconds, no checking
What you can do

Alerts your backend can rely on.

Watch what matters A wallet, a token, an app, or one kind of event. Combine them to get only what you need.
Every kind of event Payments, new tokens, burned tokens, fees, and app actions such as swaps and approvals.
New balance alerts The full new balance each time a holding changes, so you never add up transfers.
Signed alerts Each alert is signed, so your server can prove it came from Lumeus.
Automatic retries Up to 8 tries over about 4 minutes if your server doesn’t answer.
Coverage reports See every moment that wasn’t delivered, and why, then fill it from the Activity API.
Test alerts Send a signed sample alert to check your server, at no cost.
Pause and edit safely Pause, change filters or the address, and swap signing secrets with a 24-hour overlap.
Safe by design

Every alert proves where it came from.

Signed with a shared secretOnly you and Lumeus know it. Ready-made receivers check every alert and turn away old or altered ones.
Repeats are harmlessEvery alert has a stable ID, the same one the Activity API uses, so a repeat is easy to skip.
In order, one at a timeAlerts for each endpoint arrive in the order they happened.
Public addresses onlyAlerts go only to public, secure web addresses, checked on every connection.
Payment received · 480 USDCFrom Sam to Alex · arrived 14:55:04Accepted
Signed by LumeusSignature matches your secretPassed
Sent moments agoNot an old message sent againPassed
Not seen beforeIts ID is new to your recordsPassed
Next in orderArrived after the alert before itPassed
4 of 4 checks passedSafe to credit
Works with the rest of Lumeus

Start from history. Stay current with alerts.

Alerts start from the moment your webhook goes live. Everything before it, and anything missed, comes from the Activity API with the same IDs, so nothing is counted twice.

Activity API or Assets API Start from what’s there Read past payments, or today’s balances, up to the moment your webhook goes live.
Webhooks Hear about everything new Every matching event from then on, pushed to your server within seconds.
Activity API Fill any gap Anything missed is read back with the same ID, so nothing is ever counted twice.
Choose what you hear about

Every kind of event, one subscription.

Watch a wallet, a token or an app, and pick the kinds of events you want. The same alerts on the test network and the live network.

Money moved PaymentsAny token sent from one address to another. Sam to Alex480 USDC
Issued New tokensAn issuer created new units of a token. Issuer+10,000
Destroyed Burned tokensTokens taken out of circulation for good. Holder−250
Taken back ClawbacksAn issuer took tokens back from a holder. From a holder−75
Network fee FeesThe fee charged for each transaction. Paid by Alex0.0001 XLM
Smart contracts App actionsEvents from apps, such as swaps and approvals. Swap50 XLM
New balance Balance changesA holder’s full new balance after each change. Alex’s USDC8,572.30
Check your server Test alertsA signed sample alert you send yourself. Sent from youFree
Who uses it

Built for teams like yours.

Payment apps and exchangesCredit deposits as they landKnow the moment a customer’s payment arrives, and process it right away.
WalletsNotify users instantlyTell users the second money arrives, and keep balances current with balance alerts.
Back office and accountingA complete event streamSigned, ordered events with every gap reported, ready to fill from the Activity API.
Pricing

Free to build. Simple to run.

Compare all plans →
Test networkFreeTest alerts never use credits. Free includes one test endpoint, up to 1,000 alerts a day.
Live network1 credit per alertDrawn from the monthly balance every Lumeus product shares. Paid plans from $29.
Get a free key
What each alert costs on the live network
An alert delivered on the live network1 credit
Retries of the same alertCharged once
Failed or cancelled deliveries0 credits
Test alertsFree
Alerts on the test networkFree
Managing your webhooks is always free.
Endpoints: 1 on Free (test network), 10 on Starter, 50 on Growth, 250 on Scale.
Webhooks have their own key, one per network, created in your dashboard.
Ready-made receivers for Node.js, Python and Go check every signature for you.
Documentation

Go deeper in the docs.

All Webhooks docs →
Your first webhookFrom sign-up to a verified alert in about five minutes.OverviewEvent types, filters, plans and how delivery works.Receive and verifyCheck signatures, skip repeats and answer correctly.Balance alertsGet the full new balance whenever it changes.Manage webhooksPause, edit, swap signing secrets and delete.Coverage and recoveryFind anything missed and fill it from the Activity API.

Tell your users first.

Start free on the test network. Go live on any paid plan.

Start freeTalk to us