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

# Real-Time Data for Stellar API

> Access real-time Stellar token data, wallet analytics, trades, holders, historical net worth, and metadata using the Mobula API.

## Stellar API Overview

Mobula API supports Stellar. Our API integration provides access to Stellar's distinctive features for various application needs, including real-time token data, wallet analytics, trading activity, and historical performance tracking.

Stellar coverage spans both **classic** assets (SDEX order book and classic AMM liquidity pools) and **Soroban** smart contracts, with DEX indexing for Stellar Classic AMM, Soroswap, and Aquarius (constant-product, stable, and concentrated pools).

***

## Chain Identifiers

Use these values wherever an endpoint accepts a `blockchain` parameter.

| Field             | Value                                                     |
| :---------------- | :-------------------------------------------------------- |
| Chain ID          | `stellar:stellar`                                         |
| Name / aliases    | `Stellar`, `xlm`, `lumens`, `stellar-lumens`              |
| Native asset      | XLM — address `native`, 7 decimals (1 XLM = 10^7 stroops) |
| Explorer          | [stellar.expert](https://stellar.expert/explorer/public/) |
| Ledger close time | \~5s                                                      |

### Address formats

Stellar does not use EVM-style hex addresses. Mobula accepts and returns the canonical Stellar forms:

* **Native asset** — `native` (XLM).
* **Classic asset** — `CODE:ISSUER`, e.g. `USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN`.
* **Soroban contract / SAC** — `C…` strkey (56 chars), e.g. `CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA`.
* **Account (wallet)** — `G…` strkey (56 chars).
* **Classic liquidity pool** — `lp:<64-hex-pool-id>`.

The external `CODE-ISSUER` (hyphen) form used by some data providers is normalized to `CODE:ISSUER` on input.

***

## Market & Token Data

Access real-time pricing, liquidity, and token market coverage for Stellar assets.

* **[Get Token Markets](https://docs.mobula.io/rest-api-reference/endpoint/token-markets)** — View active markets and liquidity venues for Stellar tokens.
* **[Get Token Price](https://docs.mobula.io/rest-api-reference/endpoint/token-price)** — Fetch real-time price data for any Stellar token.
* **[Get Token Security](https://docs.mobula.io/rest-api-reference/endpoint/token-security-get)** — Retrieve security and risk indicators for tokens.

***

## History — Prices & OHLCV Candles

Retrieve historical price series and OHLCV candles for Stellar tokens and markets.

* **[Get Asset Price History](https://docs.mobula.io/rest-api-reference/endpoint/asset-price-history)** — Track token price performance over time.
* **[Get Token OHLCV History](https://docs.mobula.io/rest-api-reference/endpoint/token-ohlcv-history)** — Build candlestick charts for Stellar assets.
* **[Get Market OHLCV History](https://docs.mobula.io/rest-api-reference/endpoint/market-ohlcv-history)** — Query OHLCV history at the market level.

***

## Trades Data

Analyze swap activity and on-chain trade execution for Stellar tokens.

* **[Get Token Trades](https://docs.mobula.io/rest-api-reference/endpoint/token-trades)** — Retrieve recent trades for a token.
* **[Get Pair Trades](https://docs.mobula.io/rest-api-reference/endpoint/market-trades-pair)** — Fetch trades for a specific trading pair.
* **[Get Token Trade by Transaction](https://docs.mobula.io/rest-api-reference/endpoint/token-trade)** — Inspect trade details by transaction hash.

***

## Holders Data

Explore holder distribution and wallet-level token ownership insights on Stellar.

* **[Get Token Holder Positions](https://docs.mobula.io/rest-api-reference/endpoint/token-holder-positions)** — Retrieve wallet-level holder positions and token distribution.
* **[Get Top Token Trader Positions](https://docs.mobula.io/rest-api-reference/endpoint/token-trader-positions)** — Identify the most active traders for a token.

***

## Pulse API

Monitor trending tokens and ecosystem activity across Stellar and other chains.

* **[Get Pulse — GET Method](https://docs.mobula.io/rest-api-reference/endpoint/pulse-get)** — Fetch trending token and market signals.
* **[Get Pulse — POST Method](https://docs.mobula.io/rest-api-reference/endpoint/pulse-post)** — Run more advanced Pulse queries via POST.

***

## Wallet APIs

Power wallet explorers, portfolio dashboards, and trader analytics for Stellar users. Balances are read from Horizon, so trustlines, Soroban token balances, and classic liquidity-pool positions are all reflected.

* **[Get Crypto Holdings](https://docs.mobula.io/rest-api-reference/endpoint/wallet-portfolio)** — View token balances held by a `G…` account.
* **[Get Wallet Activity](https://docs.mobula.io/rest-api-reference/endpoint/wallet-activity)** — Retrieve transfers, swaps, and vault activity in one feed.
* **[Get Wallet Trades](https://docs.mobula.io/rest-api-reference/endpoint/wallet-trades)** — Fetch swap trade history executed by a wallet.
* **[Get Wallet Positions with PnL](https://docs.mobula.io/rest-api-reference/endpoint/wallet-positions)** — Analyze holdings with profit/loss metrics.
* **[Get Historical Net Worth](https://docs.mobula.io/rest-api-reference/endpoint/wallet-history)** — Track wallet net worth over time.
* **[Get Wallet Trading Analysis](https://docs.mobula.io/rest-api-reference/endpoint/wallet-analysis)** — Advanced wallet performance metrics (PnL, win rate, labels).

***

## Metacore

Access enriched metadata, search, categories, and blockchain-wide discovery tools.

* **[Get All Cryptocurrencies](https://docs.mobula.io/rest-api-reference/endpoint/all)** — List all supported tokens, including Stellar assets.
* **[Universal Search](https://docs.mobula.io/rest-api-reference/endpoint/fast-search)** — Search assets by name, symbol, or address.
* **[Get Metadata](https://docs.mobula.io/rest-api-reference/endpoint/metadata)** — Fetch detailed token metadata and identifiers.
* **[Get All Blockchains](https://docs.mobula.io/rest-api-reference/endpoint/blockchains)** — View all supported networks including Stellar.

***

## Webhook

Build real-time Stellar monitoring systems using webhook subscriptions.

* **[Get Webhook Subscription](https://docs.mobula.io/rest-api-reference/endpoint/webhook-subscriptions)** — View active webhook subscriptions.
* **[Delete Webhook Subscription](https://docs.mobula.io/rest-api-reference/endpoint/webhook-removal)** — Remove an existing webhook listener.

***

## Availability Notes

* **Swap API** — quote and execution routing is not available on Stellar. Use the Market and Trades endpoints for read-only DEX coverage.
* **NFTs** — Stellar NFT holdings are not indexed.

***

## Getting Started

To integrate Stellar functionalities with the Mobula API, begin by registering for an API key.

All Mobula endpoints require an API key: [Apply Here](https://admin.mobula.io/)
