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

Every transaction.
Since day one.

The full history of any wallet, token or app, in plain records.

Start free Read the docs
Prefer an AI assistant? Set up with your agent →
Day onehistory startsUp to 1,000records per pageAlwayssays when it’s complete
Outlined parts come straight from the Activity API
Why history is hard on Stellar

Five things that go wrong when you read history yourself.

Stellar adds a new page of records every few seconds, in coded form, and standard nodes keep only the last week. Building a usable history means reading, decoding and organising all of it.

01 / 05

Older than a week? Gone.

On your ownStandard Stellar nodes keep about a week of recent activity. Anything older means reading years of history yourself.
With the Activity APIEvery record from Stellar’s first day, ready to read, including everything before you started using Lumeus.
Alex’s activityWithout Lumeus
↓Received from SamToday+480 USDC
⇄Swapped XLM to USDC4 days ago50 XLM
Older activity isn’t availableNodes keep about a week
Only the last week
Alex’s activityWith Lumeus
Activity API · Full historyThis week
↓Received from SamToday+480 USDC
⇄Swapped XLM to USDCOct 2050 XLM
2021
↓Salary from Acme CoJun 30, 2021+2,000 USDC
March 2019
★Account openedFirst deposit+100 XLM
Complete history, back to day one
What you can ask

Everything that ever happened, readable.

A wallet’s full history Every payment, trade and fee for any wallet, back to Stellar’s first day.
Every move of a token Each time a coin or token changed hands, across the whole network.
Everything an app did Every action a smart-contract app recorded, in order.
A user’s app actions Approvals, deposits and swaps that name a user, in any app, across all history.
One transaction, explained Time, outcome, fee and note, plus everything it moved.
Money in or out Show only incoming or outgoing payments, or leave fees out.
Exact amounts Every amount also comes as an exact whole number, so totals always match.
Straight from the browser Wallet pages can read history with a key that’s safe in a web page.
History you can rely on

Every list tells you when it’s done.

Pinned to one momentYour read stays fixed while you page, so new activity never moves what you’re reading.
Complete means completeEvery list says exactly when you’ve reached the end. A short page is never mistaken for the last one.
Pick up where you left offSave one bookmark, and the next sync asks only for what’s new.
Syncing Alex’s historyPinned to 14:55:02 todayComplete
Page 11,000 recordsLoaded
Page 21,000 recordsLoaded
Page 3412 records · end of historyComplete
2,412 records savedBookmark saved Next sync asks only for what’s new.
Works with the rest of Lumeus

Load the past once. Get the future pushed.

History and live alerts share the same records and the same IDs, so joining them never misses an event or counts one twice.

Activity API Load the full history Everything a wallet, token or app ever did, up to one stated moment.
Webhooks Get new events pushed Each new matching event is sent to your server as it happens, from that moment on.
Your app Complete and current The same IDs in both, so nothing is missed and nothing is counted twice.
One record for every move

Every kind of movement, in plain words.

Payments, trades, fees, new tokens and app actions all come back the same way, with exact amounts, on the test network and the live network.

Sent and received PaymentsEvery payment, including ones routed through other coins. From Sam+480 USDC
Exchange TradesSwaps and filled orders, with both sides of the trade. XLM to USDC50 XLM
Network fees FeesThe fee of every transaction, including any refund. Network fee0.00001 XLM
Issued New tokensTokens created by their issuer, and who received them. Reward points+10,000
Burned or reclaimed Removed tokensTokens destroyed or taken back by their issuer. Reward points−500
New and closed Accounts openedAccounts being funded for the first time, or closed and merged. Account opened+100 XLM
On its way Claimed fundsMoney set aside for a wallet, and the moment it was claimed. From Sam+250 USDC
Smart-contract apps App actionsApprovals, deposits and swaps recorded by apps, findable by user. Lending appApproved
Who uses it

Built for teams like yours.

WalletsA complete payment historyShow users every payment since they opened the account, and keep it in sync.
Exchanges and payment appsCredit every depositEach payment carries its note, so you can match deposits to customers.
Accounting and taxStatements and exportsExact amounts and every fee, for any account and any date range.
Pricing

Free to build. Simple to run.

Compare all plans →
Test networkFreeUp to 10,000 requests a day on every plan. No card needed.
Live network250,000 creditsIncluded free every month, shared by every Lumeus product. Paid plans from $29.
Get a free key
Credits per request on the live network
A wallet’s history (up to 100 records)1 credit
A user’s app actions (up to 100)1 credit
One transaction, in full1 credit
A token’s or app’s activity (up to 100)5 credits
The whole network’s activity (up to 100)10 credits
Failed requests never use credits.
Up to 1,000 records per page for wallets and app actions, 200 for everything else.
Wallet pages can read history with a web-safe key.
Save your place and fetch only what’s new.
Documentation

Go deeper in the docs.

All Activity API docs →
OverviewWhat the Activity API answers, and the ways to ask.Sync a wallet’s historyLoad everything once, then keep it current.Pages and completenessHow pages stay fixed and how you know you’re done.What a record containsEvery part of a payment, trade or fee, explained.App actions by userFind approvals, deposits and swaps that name a user.Token movementsWhich app events count as real token movements.

Give your users their whole history.

Start free on the test network. Go live with the same key type.

Start freeTalk to us