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

Every balance.
Every holder.

Everything a wallet holds, and everyone who holds a token. In one request.

Start free Read the docs
Prefer an AI assistant? Set up with your agent →
One requestfor every balanceRankedholder listsLabelledaccuracy on every balance
Outlined parts come straight from the Assets API
Why balances are hard on Stellar

Five things that go wrong when you read balances yourself.

Stellar’s standard tools can look up one balance at a time, if you already know where it’s stored. They can’t tell you everything a wallet owns, what it can spend, or who holds a token.

01 / 05

Tokens kept inside apps don’t show up.

On your ownStandard tools list a wallet’s classic coins. Tokens kept inside smart-contract apps don’t appear, so a portfolio looks smaller than it is.
With the Assets APIOne request lists everything: coins, app tokens and pool shares, for people’s wallets and for apps that hold funds.
Alex’s walletWithout Lumeus
Total balance$9,132.402 of 4 assets shown
XStellar Lumens8,421.55 XLM$1,040.10
$USD Coin8,092.30 USDC$8,092.30
App tokens and pool shares missing
App tokens and pool shares missing
Portfolio looks smaller than it is
Alex’s walletWith Lumeus
Total balance$9,312.40All 4 assets
Assets API · Holdings
XStellar Lumens8,421.55 XLM$1,040.10
$USD Coin8,092.30 USDC$8,092.30
RReward pointsHeld in an app$129.90
PXLM–USDC poolPool share$50.10
Complete · as of 14:55:02
What you can ask

Every coin and token, accounted for.

Everything a wallet holds Coins, app tokens and trading pool shares, for people’s wallets and for apps that hold funds.
What can be spent now Each balance comes with the amount that can actually be sent, after the reserve and open orders.
Ranked holders Who holds any token, largest first, with the number of holders and the total held.
Any holder’s rank Where one address stands. Exact for tokens with up to 100,000 holders, refreshed regularly above that.
Token directory Search tokens by name. Get the issuer, decimal places, total held and warning flags.
Money waiting to be claimed Funds sent to a wallet that it hasn’t claimed yet, and whether it can claim them now.
Spending approvals Which apps may spend a user’s tokens, with unlimited approvals clearly marked.
Straight from the browser Wallet pages can read balances, claims and the directory with a key that’s safe in a web page.
Accuracy you can see

Every answer says how much to trust it.

Labelled one by oneEach balance says how it was confirmed: read from Stellar’s own records, or from a token format we recognise.
Complete, or it tells youEvery wallet answer says whether all balances are confirmed, and names any token it left out.
Pinned to one momentEvery answer describes the wallet exactly as it stood at one stated moment.
Alex’s walletExactly as of 14:55:02 todayComplete
XStellar LumensRead from Stellar’s records8,421.55
$USD CoinRead from Stellar’s records8,092.30
RReward pointsRecognised token format1,250.00
SSavings tokenIn long-term storage, still owned600.00
4 of 4 balances confirmedNothing left out
Works with the rest of Lumeus

Read balances once. Stay current forever.

Every answer is pinned to one exact moment. Pick up from the moment after it, and you never miss a change or count one twice.

Assets API Read every balance Get a wallet’s balances, or a token’s holders, as of one exact moment.
Webhooks or Activity API Follow what changes Get the new balance each time it changes, or every movement from the next moment on.
Your app Always current Nothing missed and nothing counted twice. No adding up transfers yourself.
One place for everything

Every kind of balance, in one answer.

Coins, app tokens, pool shares, money on its way and funds set aside, all read the same way, on the test network and the live network.

Stellar’s own coin XLMWith what’s ready to send. Ready to send7,997.05
Stablecoins and assets Issued coinsUSDC, EURC and every other Stellar asset. USD Coin8,092.30
Smart-contract tokens App tokensTokens created by apps, for wallets and apps. Reward points1,250.00
Trading pools Pool sharesShares in a pool, with its two assets and fee. XLM–USDC pool42.10
On its way Money to claimFunds sent to a wallet, and whether it can claim them now. From Sam250.00
On the exchange Open ordersAmounts set aside for open trades. Selling XLM420.00
Permissions Spending approvalsWhich apps can spend a user’s tokens, and how much. Lending appUnlimited
Resting balances Long-term storageShown in full and labelled, ready the next time they’re used. Savings token600.00
Who uses it

Built for teams like yours.

WalletsA complete, honest portfolioEvery balance with what can be sent, pending claims, and look-alike tokens hidden.
Token issuersKnow your holdersRanked holder lists, the number of holders and the total held for your token.
Exchanges and accountingCheck before you payConfirm what an account holds and can send before a payout, with an exact moment for your records.
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 balances (up to 100)1 credit
A token search, or one token1 credit
Claims, orders or approvals (up to 100)1 credit
One holder’s balance and rank2 credits
A page of top holders (up to 100)5 credits
Failed requests never use credits.
Up to 200 results per page, with a link to the next page.
Wallet pages can read balances, claims and the directory with a web-safe key.
Every answer states the exact moment it describes.
Documentation

Go deeper in the docs.

All Assets API docs →
OverviewWhat the Assets API answers, and how answers are pinned to a moment.HoldingsEverything an address holds, and what it can spend.Token holdersRanked holder lists and one holder’s rank.Token directorySearch tokens, read names, totals and warning flags.Claims, orders, approvalsWhat’s pending, locked or approved for an address.AccuracyHow each balance is confirmed, and when an answer is complete.

Show users everything they own.

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

Start freeTalk to us