> For the complete documentation index, see [llms.txt](https://docs.openalgo.in/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openalgo.in/trading-platform/mobile-app.md).

# Mobile App

**OpenAlgo Terminal** is a Flutter mobile trading app that connects to your own OpenAlgo server. It is a **frontend only** application: it holds no broker credentials of its own, stores no data centrally, and talks exclusively to the server URL and API key you give it.

* Repository: [marketcalls/openalgo-mobile](https://github.com/marketcalls/openalgo-mobile)
* Built with Flutter and Dart
* Platforms: Android and Web
* Licence: AGPL-3.0

***

## What It Does

### Trading

| Feature              | Description                                      |
| -------------------- | ------------------------------------------------ |
| **Watchlist**        | Track multiple instruments with real-time quotes |
| **Live market data** | Price updates on a rolling refresh               |
| **Order management** | Place, modify and cancel orders                  |
| **Positions**        | Monitor open positions and holdings              |
| **Tradebook**        | Full history of executions                       |
| **Market depth**     | Level 2 order book                               |
| **Account overview** | Available cash, used margin and P\&L             |

### Other

| Feature                 | Description                                                                     |
| ----------------------- | ------------------------------------------------------------------------------- |
| **Analyzer mode**       | Switch between live and analyze (paper trading) without leaving the app         |
| **Configurable header** | Choose the indices on the header, such as NIFTY, BANKNIFTY, SENSEX and INDIAVIX |
| **Themes**              | Light and dark                                                                  |

***

## Prerequisites

You need a **running OpenAlgo server** and an API key from its dashboard. The app is a client; it cannot trade on its own.

* Install OpenAlgo from [Getting Started](/installation-guidelines/getting-started.md), or
* Point the app at a server you already run

Then generate an API key from the `/apikey` page of that server.

***

## Connecting

The app asks for two things on first run:

1. **Server URL**, for example `https://yourdomain.com` or your local address
2. **API key**, from your OpenAlgo dashboard

{% hint style="warning" %}
Reaching a **local** OpenAlgo install from a phone needs the server to be accessible from the phone's network. `127.0.0.1` refers to the phone itself, not your computer.

Use your machine's LAN address, or expose the server properly with one of the tunnelling or custom domain guides under [Getting Started](/installation-guidelines/getting-started.md). Anything you expose publicly needs TLS and the usual hardening: the API key is the credential that resolves your broker session.
{% endhint %}

***

## Security Model

The app follows the same principle as the rest of OpenAlgo: **your broker credentials never leave your server.**

* The app holds an **OpenAlgo API key**, not broker credentials
* The server resolves that key to the active broker session
* Revoking the key from the dashboard cuts the app off without touching your broker account
* No trading data passes through any third party

***

## Related

* [Chrome Extension](/trading-platform/chrome-extension.md) for browser-based order entry
* [Mini FOSS Universe](/mini-foss-universe.md) for the rest of the ecosystem
* [Getting Started](/installation-guidelines/getting-started.md) to set up the server the app connects to