SwapTradePoolsPortfolioDocs
OverviewConceptsUsing the appContractsIntegrate (SDK, MCP)Bots and volumeFAQ

Documentation

Lotus docs

Directional liquidity and yield-bearing orders for Stellar. One order, four places to wait. Written for people and for AI agents: every page is also served as raw Markdown at /docs/<page>.md.

Stellar testnet only. Not audited.

OverviewLotus is directional liquidity and yield-bearing orders for Stellar. One order, chosen once, waits in one of four places. Everything runs on Stellar testnet; nothing is on mainnet and nothing is audited.ConceptsThe directional range pool and its bins, the four places an order can wait, the receipt token and its redemption at par, the curator rule, and why orders are locked until filled.Using the appA walk through every screen: get test tokens on /faucet, swap or place one-price and range orders on /swap, build a position across the four strategies on /pools, trade the SDEX books on /trade, and manage everything on /portfolio.ContractsThe lotus_pool ABI (v1), the lotus_vault interface, their errors and events, and the live testnet addresses read from the deployment config at request time.IntegrateThree ways to build on Lotus: the HTTP endpoints of this app, a TypeScript SDK, and an MCP server that lets AI agents (Claude Code, Codex, Cursor, ...) read the markets and build transactions. Testnet only.Bots and volumeThe trades on the Lotus testnet markets come from accounts run by the Lotus team. They are real on-chain transactions, but it is market-maker volume, not user volume. The LBOND price is simulated.FAQShort, honest answers to the questions judges and integrators ask. Everything described runs on Stellar testnet unless stated otherwise. Nothing is audited.

For AI agents

/llms.txtIndex for LLMs (llmstxt.org): every page as raw Markdown, plus the API endpoints./llms-full.txtAll pages concatenated in one file, ready to paste into a context window./api/healthJSON deployment check: RPC, Horizon, and every pool and vault contract.SDK and MCPQuote and build transactions from code or from an AI agent.