> ## 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.

# Introduction

> A trading client for Polymarket — on Telegram, in a web terminal, and in your browser.

Ballista is a trading client for Polymarket. It gives you limit orders, copy
trading, backtesting and price alerts on top of the markets Polymarket already
runs — from a Telegram chat, a web terminal, or a Chrome extension that sits on
the Polymarket site itself.

Ballista is not an exchange and does not hold a market of its own. Every order
you place is signed and sent to Polymarket's central limit order book. The
markets, the prices, the liquidity and the resolution of every question are
Polymarket's.

## One account, three surfaces

You register once, in the Telegram bot. That one registration creates your
wallet and your Polymarket account, and the terminal and the extension sign in
to the same account with the Telegram login widget. There is one balance and one
set of positions behind all three — deposit in the bot, trade in the terminal,
close in the extension.

<CardGroup cols={3}>
  <Card title="Telegram bot" icon="telegram" href="/telegram/overview">
    Where you register, deposit, and build full copy-trade configurations.
  </Card>

  <Card title="Web terminal" icon="desktop" href="/terminal/overview">
    Markets, portfolio, the leaderboard and the backtester on a full screen.
  </Card>

  <Card title="Chrome extension" icon="chrome" href="/extension/install">
    Trade and set price alerts without leaving polymarket.com.
  </Card>
</CardGroup>

## Which surface does what

Feature coverage is not the same everywhere, and it is worth knowing before you
go looking for something.

|                                          | Telegram           | Terminal          | Extension               |
| ---------------------------------------- | ------------------ | ----------------- | ----------------------- |
| Register a new account                   | Yes — the only way | No                | No                      |
| Deposit addresses and balance            | Yes                | Yes               | Yes                     |
| Market and limit **buys**                | Yes                | Yes               | Yes                     |
| **Selling**                              | No                 | Yes               | Yes                     |
| Positions                                | Yes                | Yes               | Yes                     |
| Open orders, and cancelling one          | No                 | Yes               | Yes                     |
| Trade history                            | No                 | Per market        | Yes                     |
| Copy trading                             | Full configuration | Short form        | No                      |
| Backtester, leaderboard, trader profiles | No                 | Yes               | No                      |
| Price alerts and notifications           | No                 | No                | Yes                     |
| Order presets                            | No                 | Create and delete | Create, edit and delete |
| Referrals                                | Yes                | No                | No                      |

<Warning>
  The Telegram bot is **buy-only**. It has no sell action anywhere — not on the
  positions screen, not in a market. To close a position, or to cancel an order
  you placed from the bot, use the terminal or the extension.
</Warning>

<Info>
  The Telegram copy-trade form exposes every setting the engine supports; the
  terminal's is a short form for the common case. See
  [Copy-trade settings](/guides/copy-trade-settings) for what each control does.
</Info>

## What to read next

<CardGroup cols={2}>
  <Card title="Create your account" icon="user-plus" href="/guides/create-account">
    One `/start` in the bot provisions everything.
  </Card>

  <Card title="How your account works" icon="sitemap" href="/guides/how-it-works">
    The wallet Ballista holds, and the Polymarket wallet it signs for.
  </Card>

  <Card title="Deposits" icon="wallet" href="/guides/deposits">
    Four addresses, six EVM chains, Solana and Bitcoin. \$10 minimum.
  </Card>

  <Card title="Placing orders" icon="chart-line" href="/guides/orders">
    Market and limit orders, and the bounds they have to satisfy.
  </Card>

  <Card title="Copy trading" icon="copy" href="/guides/copy-trading">
    Mirror another wallet's fills, with your own size and filters.
  </Card>

  <Card title="What Ballista does not do" icon="ban" href="/guides/what-ballista-does-not-do">
    The limits, stated plainly, before you run into one.
  </Card>
</CardGroup>