> ## 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 Testnet API

> Access real-time Stellar Testnet token data, wallet analytics, trades, holders, and metadata using the Mobula API before shipping to mainnet.

## Stellar Testnet API Overview

Mobula API supports Stellar Testnet. It mirrors [Stellar mainnet](/blockchains/stellar) — same endpoints, same request shapes, same address formats — pointed at the SDF test Horizon and Soroban RPC, so you can build and validate a Stellar integration before switching the `blockchain` parameter to `stellar: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:testnet`                                                    |
| Name / aliases    | `Stellar Testnet`, `xlm-testnet`, `stellar-lumens-testnet`           |
| Native asset      | XLM — address `native`, 7 decimals (1 XLM = 10^7 stroops)            |
| Explorer          | [stellar.expert (testnet)](https://stellar.expert/explorer/testnet/) |
| Ledger close time | \~5s                                                                 |

Address formats are identical to mainnet: `native`, `CODE:ISSUER` classic assets, `C…` Soroban contracts, `G…` accounts, and `lp:<64-hex-pool-id>` classic pools. See [Stellar → Address formats](/blockchains/stellar#address-formats).

<Note>
  Stellar Testnet is periodically reset by the Stellar Development Foundation. Accounts, assets, and contracts do not survive a reset — treat all testnet data as disposable.
</Note>

***

## Market & Token Data

Access pricing, liquidity, and token market coverage for Stellar Testnet assets.

* **[Get Token Markets](https://docs.mobula.io/rest-api-reference/endpoint/token-markets)** — View active markets and liquidity venues for testnet tokens.
* **[Get Token Price](https://docs.mobula.io/rest-api-reference/endpoint/token-price)** — Fetch price data for any Stellar Testnet 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 testnet 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 testnet 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 Testnet 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 Testnet.

* **[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.

***

## Wallet APIs

Balances for a `G…` testnet account are fetched from test Horizon, covering XLM, trustline assets, Soroban token balances, and classic liquidity-pool positions.

* **[Get Crypto Holdings](https://docs.mobula.io/rest-api-reference/endpoint/wallet-portfolio)** — View token balances held by a testnet account. Pass `blockchains=stellar:testnet`.
* **[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.

***

## Metacore

* **[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)** — Resolve name, symbol, and decimals for a testnet asset or Soroban token.
* **[Get All Blockchains](https://docs.mobula.io/rest-api-reference/endpoint/blockchains)** — View all supported networks including Stellar Testnet.

***

## Availability Notes

* **Swap API** — quote and execution routing is not available on Stellar Testnet or [Stellar mainnet](/blockchains/stellar). Use the Market and Trades endpoints for read-only DEX coverage.
* **NFTs** — Stellar NFT holdings are not indexed.

***

## Getting Started

To integrate Stellar Testnet 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/)