> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ballista.gg/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Ballista is a trading client for Polymarket, not an exchange. Every order Ballista places goes to Polymarket's CLOB.
> There are three end-user surfaces — the Telegram bot, the web terminal and the Chrome extension — and they share ONE account and ONE balance. Never attribute a feature to a surface without checking that surface's source.
> Every user registers in the Telegram bot first. The terminal and the extension sign in with the Telegram login widget. There is no other sign-up path.
> Deposits arrive through EVM, Solana and Bitcoin bridge addresses and a Polymarket proxy wallet, with a $10 minimum. There is NO withdrawal UI — Export Keys is how a user takes custody of their funds.
> Feature parity is uneven and must never be assumed. The full ~30-field copy-trade form exists only in Telegram; the terminal's copy form has 7 fields; the backtester, leaderboard and trader profiles are terminal-only; alerts and notifications are extension-only; referrals are Telegram-only.
> Slippage means two different things. On a live copy trade it is a fill tolerance (default 30). In a backtest it is the simulated fill price (default 1). Deploying a backtest does not carry its slippage over to the live copy trade.
> Take-profit and stop-loss run on live copy trades but are NOT simulated in backtests — the backtest API rejects those fields.
> A backtest never places an order and never moves funds. Its fidelity caveats are published with every result and must be quoted, not paraphrased.
> Leaderboard PnL is own-tape: harvested by Ballista from its own trade tape. The leaderboard sorts by one transparent metric at a time and there is NO composite score or grade. The sparkline exists only for harvested wallets — a blank sparkline means unmeasured, never zero.
> Copy friction (slip) and a toxic flag DO exist and are own-engine: the wallet's own 30-day fills replayed as a taker (1% slippage per fill plus the real Polymarket taker fee schedule) against its actual 30-day PnL over the same fills, so the delta is pure friction. slip_pct is already a percentage, not a 0-1 fraction. The toxic flag is server-computed under evidence guards and is never re-derived client-side. Slip is not a sortable column. Blank means unmeasured — never zero and never clean.
> Copyability is a taker share, reported in aggressive (≥60%), passive (≤30%) and mixed bands. It is never a score.
> Do not document Feeds, the Twitter Tracker, the Telegram Settings button, percentage buy buttons, GTD orders, the Discord bot, or withdrawals.
# The terminal
> The web surface of Ballista: what is on screen, and what only lives here.
The terminal is Ballista in a browser. It shares one account and one balance with the
Telegram bot and the Chrome extension — orders you place here settle into the same
Polymarket positions, and a deposit made anywhere shows up everywhere.
It is also the only surface with the [backtester](/terminal/backtester), the
[leaderboard](/terminal/leaderboard) and [trader profiles](/terminal/trader-profile).
You register in the Telegram bot first, then sign in here with the Telegram login
widget. See [Signing in](/guides/signing-in).
## The nav rail
The rail down the left side is how you move between sections.
| Section | What it is |
| ---------------- | ------------------------------------------------------------------------------- |
| **Markets** | Every market, by category and sort. The only section you can browse signed out. |
| **Watchlist** | The markets you have starred. |
| **Portfolio** | Your balance, positions and open orders. |
| **Leaderboard** | Wallets worth looking at, ranked one metric at a time. |
| **Copy Trading** | Mirror a wallet, and review what was mirrored. |
| **Backtester** | Replay a configuration against a wallet's real fills. |
| **Settings** | Your order presets. |
Of the sections above, every one but Markets needs a session. Open one signed out and
you get a sign-in prompt rather than a broken page. The rail carries a couple of other
entries that are placeholders for features that are not built yet.
The button at the bottom of the rail collapses it to icons only. The choice is
remembered in that browser.
## The top bar
Left to right: the name of the section you are in, a search box, and the account
controls.
The search box is a live search over markets. Type in it and the Markets page
reloads with your results after a short pause — you do not press Enter. It is the
same search the ⌘K palette runs, so use whichever is closer to hand; see
[Getting around](/terminal/navigating).
## Connect, Deposit, Disconnect
**Connect** opens the sign-in dialog. You must have registered in the Ballista
Telegram bot before this will work.
**Deposit** opens your deposit addresses without leaving the page you are on. You
get one address for six EVM networks, one for Solana, one for Bitcoin, and your
Polymarket profile address for sending straight to the proxy wallet with no bridge
in between. Each address has a copy button, and your current balance sits at the top
of the dialog next to links to your Polymarket profile and PolygonScan. The minimum
is \$10. Full detail is in [Deposits](/guides/deposits).
The first time you open it — or the first time you try to trade — you may be asked to
set up your wallet. That is a one-time step that provisions your proxy wallet and
bridge addresses, and it can take a minute.
**Disconnect** signs you out of this browser. It does nothing to your account, your
positions or your copy trades; sign back in and everything is where you left it.
## Light and dark
Both themes are fully designed, not one inverted into the other. The terminal follows
your operating system's setting by default, and the sun/moon button in the top bar
overrides it. The choice is remembered in that browser, and it carries between tabs.
Pressing **d** is the faster way to switch, and the more reliable one — the button can
need two clicks the first time you use it. Both are covered in
[Getting around](/terminal/navigating).
## What to read next
The command palette, search, and the one keyboard shortcut worth knowing.
Categories, sorts, and the live crypto board.