cURL

curl --fail-with-body -sS 'https://assets-testnet.lumeus.dev/accounts/GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR/holdings?limit=10' \
  -H "Authorization: Bearer $LUMEUS_API_KEY"

// Node 18+ (ES module)
const res = await fetch('https://assets-testnet.lumeus.dev/accounts/GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR/holdings?limit=10', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_API_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

import json
import os

import requests

res = requests.get(
    "https://assets-testnet.lumeus.dev/accounts/GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR/holdings?limit=10",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"},
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "_embedded": {
    "records": [
      {
        "asset": "native",
        "asset_type": "native",
        "kind": "native",
        "contract_id": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
        "code": "XLM",
        "issuer": null,
        "name": "Lumens",
        "symbol": "XLM",
        "decimals": 7,
        "balance": "7054567984.5299856",
        "balance_raw": "70545679845299856",
        "source": "ledger_entry",
        "verified": true,
        "archived": false,
        "live_until_ledger": null,
        "authorized": null,
        "maintain_liabilities": null,
        "clawback": null,
        "limit": null,
        "buying_liabilities": "0.0000000",
        "selling_liabilities": "0.0000000",
        "spendable": "7054567983.5299856",
        "last_modified_ledger": 5332632,
        "flags": [],
        "paging_token": "Im5hdGl2ZSI"
      }
    ]
  },
  "_links": {
    "self": {
      "href": "/accounts/GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR/holdings?limit=10"
    }
  },
  "account": {
    "balance": "7054567984.5299856",
    "base_reserve": "0.5000000",
    "buying_liabilities": "0.0000000",
    "flags": 0,
    "home_domain": "",
    "id": "GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR",
    "last_modified_ledger": 5332632,
    "minimum_balance": "1.0000000",
    "selling_liabilities": "0.0000000",
    "sequence": "695784702525",
    "spendable": "7054567983.5299856",
    "sponsored": 0,
    "sponsoring": 0,
    "subentries": 0
  },
  "address": "GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR",
  "completeness": {
    "complete": true,
    "note": "every holding is read from protocol ledger entries or recognized SEP-41 storage",
    "simulated": 0,
    "simulation_skipped": 0,
    "unverified": 0,
    "unverified_contracts": [],
    "verified": 1
  },
  "limit": 10,
  "read_view": {
    "network": "testnet",
    "generation": "assets-testnet-v1-5253887",
    "as_of_ledger": 5332635,
    "as_of_closed_at": "2026-10-22T16:32:42Z",
    "bootstrap_ledger": 5253887
  }
}

List holdings of an address

Every balance the address holds: XLM, trustlines (including zero balances with include=zero), liquidity pool shares, and SAC and custom-token balances held in contract storage, live or archived. Sorted by asset. Each record says how it was determined (source, verified); the completeness block says whether the whole answer is verified. G accounts also get an account block with spendable XLM; an unfunded or unknown G address answers 200 with account: null and no records. With as_of_ledger the holdings are read at a past ledger from the balance history (credit class assets-history, weight 5): include=closed is not available, unverified balances are not simulated, and publishable keys are not allowed. The history begins at read_view.bootstrap_ledger at the earliest; earlier ledgers need a snapshot job (POST /snapshots). Credit class assets-holdings: 1 × ceil(rows/100), at least one credit per started 64 KiB. Each unverified token simulated adds 1 credit. Publishable keys allowed.

Unknown or repeated query parameters return 400, so a typo or an unsupported filter never returns unfiltered data.

GET

accounts

{address}

holdings

cURL

curl --fail-with-body -sS 'https://assets-testnet.lumeus.dev/accounts/GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR/holdings?limit=10' \
  -H "Authorization: Bearer $LUMEUS_API_KEY"

// Node 18+ (ES module)
const res = await fetch('https://assets-testnet.lumeus.dev/accounts/GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR/holdings?limit=10', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_API_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

import json
import os

import requests

res = requests.get(
    "https://assets-testnet.lumeus.dev/accounts/GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR/holdings?limit=10",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"},
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "_embedded": {
    "records": [
      {
        "asset": "native",
        "asset_type": "native",
        "kind": "native",
        "contract_id": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
        "code": "XLM",
        "issuer": null,
        "name": "Lumens",
        "symbol": "XLM",
        "decimals": 7,
        "balance": "7054567984.5299856",
        "balance_raw": "70545679845299856",
        "source": "ledger_entry",
        "verified": true,
        "archived": false,
        "live_until_ledger": null,
        "authorized": null,
        "maintain_liabilities": null,
        "clawback": null,
        "limit": null,
        "buying_liabilities": "0.0000000",
        "selling_liabilities": "0.0000000",
        "spendable": "7054567983.5299856",
        "last_modified_ledger": 5332632,
        "flags": [],
        "paging_token": "Im5hdGl2ZSI"
      }
    ]
  },
  "_links": {
    "self": {
      "href": "/accounts/GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR/holdings?limit=10"
    }
  },
  "account": {
    "balance": "7054567984.5299856",
    "base_reserve": "0.5000000",
    "buying_liabilities": "0.0000000",
    "flags": 0,
    "home_domain": "",
    "id": "GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR",
    "last_modified_ledger": 5332632,
    "minimum_balance": "1.0000000",
    "selling_liabilities": "0.0000000",
    "sequence": "695784702525",
    "spendable": "7054567983.5299856",
    "sponsored": 0,
    "sponsoring": 0,
    "subentries": 0
  },
  "address": "GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR",
  "completeness": {
    "complete": true,
    "note": "every holding is read from protocol ledger entries or recognized SEP-41 storage",
    "simulated": 0,
    "simulation_skipped": 0,
    "unverified": 0,
    "unverified_contracts": [],
    "verified": 1
  },
  "limit": 10,
  "read_view": {
    "network": "testnet",
    "generation": "assets-testnet-v1-5253887",
    "as_of_ledger": 5332635,
    "as_of_closed_at": "2026-10-22T16:32:42Z",
    "bootstrap_ledger": 5253887
  }
}

Authorizations

Authorization

string

header

required

Send Authorization: Bearer <key>, the same keys as Activity and RPC. Testnet: lum_test_…; Mainnet: lum_live_…. A key works only on its own network, so pick the server that matches it (the other network answers 401). Publishable lum_pub_… keys work only on the routes marked "Publishable keys allowed", from an allowed browser origin.

Path Parameters

address

string

required

Checksum-valid G or C address. An M… address resolves to its G account and the response carries muxed_input. B… and L… addresses are never holders.

Example:

"GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR"

Query Parameters

kind

enum<string>

Only holdings of this kind.

Available options:

native,

trustline,

pool_share,

contract

Example:

"trustline"

min_balance

string

Decimal; holdings below it are left out.

Pattern: ^[0-9]+(\.[0-9]+)?$

Example:

"1"

include

string

Comma list: zero (zero-balance trustlines), closed (previously held, with closed_ledger), unverified (event-derived or simulated custom-token balances). Default: none of them.

Pattern: ^(zero|closed|unverified)(,(zero|closed|unverified))*$

Example:

"zero"

asset

string

Only this asset: native, CODE:ISSUER (case-sensitive), a C… token contract ID or pool:<64 hex>. A Stellar Asset Contract ID matches the balances of its classic asset (CODE:ISSUER, or native for the native SAC), which records report under that classic ID.

as_of_ledger

integer

Read at this past ledger from the balance history (credit class assets-history, weight 5). 400 when after the latest applied ledger; 409 when the history cannot answer it exactly. Not available to publishable keys.

Required range: x >= 1

Example:

5300000

limit

integer

default:50

Records per page, 1 to 200 (default 50).

Required range: 1 <= x <= 200

Example:

10

cursor

string

Resume after this paging_token. Prefer following _links.next.href.

Response

A page of holdings, the completeness block and, for a G account, the account entry.

read_view

object

required

Show child attributes

limit

integer

required

Effective page size: default 50, maximum 200.

_links

object

required

Show child attributes

_embedded

object

required

Show child attributes

address

string

required

The looked-up address (G or C; an M… input resolves to its G account).

completeness

object

required

Show child attributes

account

object | null

G accounts only: the account entry, or null when the account does not exist. Absent for C addresses.

Show child attributes

muxed_input

string

The M… address from the request, when one was sent.

Activity API

Assets API

Webhooks

RPC

Account

List holdings of an address

Authorizations

Path Parameters

Query Parameters

Response