> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumeus.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Lumeus docs

> Stellar Mainnet and Testnet. Activity, assets, webhooks and RPC.

> **[Activity API](/activity/overview.md)**
>
> Read account history and decoded Stellar events.

> **[Assets API](/assets-api/overview.md)**
>
> Read balances, token holders and the token registry.

> **[Webhooks](/webhooks/overview.md)**
>
> Receive signed events at your HTTPS endpoint.

> **[RPC](/rpc/overview.md)**
>
> Query state, simulate and submit transactions.

## Get started

> **[Quickstart](/quickstart.md)**
>
> Sign up, copy your key and make your first call.

> **[Set up with an agent](/agents/overview.md)**
>
> One prompt for Claude Code, Cursor or Codex.

> **[Plans and pricing](/guides/billing.md)**
>
> Testnet is free. Credits are for Mainnet.

Sign up at [app.lumeus.dev](https://app.lumeus.dev) to get a Testnet key in
under a minute. No card is needed, and Testnet is free.

## Try it

With a Testnet key, one request lists the three largest XLM holders on Testnet:

```bash theme={null}
export LUMEUS_API_KEY='paste-your-lum_test_-key'

curl --fail-with-body -sS -G 'https://assets-testnet.lumeus.dev/assets/native/holders' \
  --data-urlencode limit=3 \
  -H "Authorization: Bearer $LUMEUS_API_KEY" |
  jq -r '._embedded.records[] | "\(.balance) XLM  \(.holder)"'
```

```text Output theme={null}
53757260427.8488203 XLM  GBFAIH5WKAJQ77NG6BZG7TGVGXHPX4SQLIJ7BENJMCVCZSUZPSISCLU5
7056467984.5299856 XLM  GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR
206509999.7935000 XLM  GATXZXYXXG4ARRZC4G7KYK3OXQFSR4DWPXWJ7R6TEG3J6LPUFDV745EY
```

The [quickstart](/quickstart.md) takes you from sign-up to your first Activity,
Assets and RPC calls, in curl, JavaScript and Python, in about five minutes.

## Base URLs

**Testnet**

| API | Base URL |
| - | - |
| Activity | `https://api-testnet.lumeus.dev` |
| Assets | `https://assets-testnet.lumeus.dev` |
| Webhooks | `https://webhooks-testnet.lumeus.dev` |
| RPC | `https://rpc-testnet.lumeus.dev` |

**Mainnet**

| API | Base URL |
| - | - |
| Activity | `https://api.lumeus.dev` |
| Assets | `https://assets.lumeus.dev` |
| Webhooks | `https://webhooks.lumeus.dev` |
| RPC | `https://rpc.lumeus.dev` |

Activity, Assets and RPC share one API key per network. Webhooks uses a separate
key. All four accept `Authorization: Bearer <key>`. See
[authentication](/guides/authentication.md).

## Plans

Build and test on Testnet for free: up to 10,000 requests a day, reset at
00:00 UTC, on every plan (unlimited on Enterprise). Credits are for Mainnet.
Every workspace starts on Free, with 250,000 Mainnet credits a month and one
Testnet webhook endpoint. Starter, Growth and Scale add credits, higher rate
limits and webhooks on both networks. Upgrade any time in the dashboard. See
[plans and billing](/guides/billing.md).

## History and retention

Activity covers the full history of supported events, back to genesis on
Mainnet. RPC keeps about seven days of recent ledgers; use the Activity API for
anything older. See [event coverage](/activity/events.md) and
[health checks](/guides/readiness.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.