# Ballista

> Trade Polymarket like a pro — limit orders, copy trading, price alerts and backtesting, on Telegram, the web terminal and Chrome.

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

## Docs

- [Price alerts](https://docs.ballista.gg/extension/alerts.md): The bell sheet: what has happened, what is still watching, and how to set a new price alert.
- [Desktop notifications](https://docs.ballista.gg/extension/desktop-notifications.md): How the extension tells you something has happened, even when the popup is closed.
- [History tab](https://docs.ballista.gg/extension/history-tab.md): Orders still resting on the book, how to cancel them, and the record of what has filled.
- [Install the extension](https://docs.ballista.gg/extension/install.md): Where to download the Ballista extension, how to load it in Chrome, and what each permission is for.
- [Markets tab](https://docs.ballista.gg/extension/markets-tab.md): Search Polymarket, open a market, and place a buy or sell without leaving the popup.
- [The on-page panel](https://docs.ballista.gg/extension/on-page-panel.md): The Ballista panel that sits on Polymarket's own market pages: pick an outcome, fire a preset, set an alert.
- [Positions tab](https://docs.ballista.gg/extension/positions-tab.md): Everything you hold, with an inline market or limit order to sell out of it.
- [Presets tab](https://docs.ballista.gg/extension/presets-tab.md): Create, edit and delete the one-click order presets used across Ballista.
- [Sign in](https://docs.ballista.gg/extension/sign-in.md): Logging the extension into your Ballista account with Telegram.
- [Wallet tab](https://docs.ballista.gg/extension/wallet-tab.md): Your portfolio value, your Polymarket address, and the deposit addresses for Ethereum, Solana and Bitcoin.
- [Price alerts](https://docs.ballista.gg/guides/alerts.md): Get a desktop notification when a market crosses a price you picked.
- [Backtest fidelity](https://docs.ballista.gg/guides/backtest-fidelity.md): The standing list of ways a simulated run is not reality — shipped with every result, in full.
- [Backtesting](https://docs.ballista.gg/guides/backtesting.md): Replay a leader's real trades through your copy-trade configuration, before you point real money at it.
- [Choosing a trader](https://docs.ballista.gg/guides/choosing-a-trader.md): Taker share tells you whether a wallet can be copied at all — which is a different question from whether it makes money.
- [Copy trade settings](https://docs.ballista.gg/guides/copy-trade-settings.md): Every field on a copy trade, what it does to your orders, and what happens when you leave it blank.
- [Copy trading](https://docs.ballista.gg/guides/copy-trading.md): Mirror one wallet's Polymarket trading into your own account, order for order, on your own rules.
- [Create your account](https://docs.ballista.gg/guides/create-account.md): One command in the Telegram bot creates your wallet and your Polymarket account.
- [Deposits](https://docs.ballista.gg/guides/deposits.md): Four addresses, minimum $10, and the assets each one accepts.
- [Getting help](https://docs.ballista.gg/guides/getting-help.md): Where to ask, what to include, and what never to send.
- [How your account works](https://docs.ballista.gg/guides/how-it-works.md): The wallet Ballista holds, the Polymarket wallet it signs for, and the one balance behind every surface.
- [The leaderboard](https://docs.ballista.gg/guides/leaderboard.md): Who appears on the board, what it ranks on, and why a blank cell is never a zero.
- [Limits](https://docs.ballista.gg/guides/limits.md): Every minimum, cap and window, with what happens when you hit one.
- [Placing orders](https://docs.ballista.gg/guides/orders.md): Market orders, limit orders, and the bounds every order has to satisfy.
- [Presets](https://docs.ballista.gg/guides/presets.md): Saved size and price templates so a repeated order is one click.
- [Reading a result](https://docs.ballista.gg/guides/reading-a-result.md): The reliability verdict, boundary exposure, structural share, data gaps and fee confidence — and what each one does to your confidence in the headline.
- [Referrals](https://docs.ballista.gg/guides/referrals.md): Invite people with a permanent code and earn a share of the fees they pay.
- [Signing in](https://docs.ballista.gg/guides/signing-in.md): The terminal and the extension sign in with the Telegram login widget.
- [Trader profiles](https://docs.ballista.gg/guides/trader-profiles.md): Why a profile shows recent and lifetime numbers separately, where each comes from, and what a backtest unlocks.
- [Your wallet and keys](https://docs.ballista.gg/guides/wallet-and-keys.md): Export Keys hands you the raw private key. Here is what it controls and how to handle it.
- [What Ballista does not do](https://docs.ballista.gg/guides/what-ballista-does-not-do.md): The limits, stated plainly, so none of them are a surprise later.
- [Introduction](https://docs.ballista.gg/introduction.md): A trading client for Polymarket — on Telegram, in a web terminal, and in your browser.
- [Buying](https://docs.ballista.gg/telegram/buying.md): Paste a Polymarket link and buy Yes or No, at market or at a limit price.
- [Commands](https://docs.ballista.gg/telegram/commands.md): The six slash commands the bot understands.
- [The copy-trade form](https://docs.ballista.gg/telegram/copy-trade-form.md): Every field on the bot's copy-trade form, in the order you meet it.
- [Copy trades](https://docs.ballista.gg/telegram/copy-trades.md): Create, browse and edit the copy trades that mirror another wallet.
- [The main menu](https://docs.ballista.gg/telegram/main-menu.md): Your balance, a deposit address, and the buttons that reach everything else.
- [Telegram bot](https://docs.ballista.gg/telegram/overview.md): Register, deposit, buy markets and run copy trades from a chat window.
- [Positions](https://docs.ballista.gg/telegram/positions.md): Everything you currently hold, with size, average price and value.
- [Referrals](https://docs.ballista.gg/telegram/referrals.md): Claim your code, share your link, and track what your referrals earn you.
- [Wallet and deposits](https://docs.ballista.gg/telegram/wallet.md): Your deposit addresses on every chain, your profile links, and key export.
- [A backtest result](https://docs.ballista.gg/terminal/backtest-results.md): The tiles, the charts, the per-market table, the skip breakdown and the exports.
- [Running a backtest](https://docs.ballista.gg/terminal/backtester.md): Submitting a run: the form, the queue, and what the run list can and cannot show you.
- [Copy trading](https://docs.ballista.gg/terminal/copy-trading.md): The terminal's simplified copy-trade form, the active list, and execution history.
- [Deploying a backtest](https://docs.ballista.gg/terminal/deploy-a-backtest.md): Turning a finished run into a copy trade — what carries over, and what deliberately does not.
- [Leaderboard](https://docs.ballista.gg/terminal/leaderboard.md): Filters, sorts, columns, the 30-day trend line, and what a blank cell means.
- [A market page](https://docs.ballista.gg/terminal/market-page.md): The chart, the order book, and the four tabs under them.
- [Markets](https://docs.ballista.gg/terminal/markets.md): Browsing by category, sorting, and the live crypto board.
- [Getting around](https://docs.ballista.gg/terminal/navigating.md): The command palette, the search box, and the theme shortcut.
- [The terminal](https://docs.ballista.gg/terminal/overview.md): The web surface of Ballista: what is on screen, and what only lives here.
- [Placing an order](https://docs.ballista.gg/terminal/placing-orders.md): The trade panel: outcome, side, order type, size, and the quick-order chips.
- [Portfolio](https://docs.ballista.gg/terminal/portfolio.md): Your balance, your open positions and their P&L, and your open orders.
- [Presets](https://docs.ballista.gg/terminal/presets.md): Saving an order you place often, and firing it from a market page.
- [A trader profile](https://docs.ballista.gg/terminal/trader-profile.md): Provenance, recent activity, lifetime stats, copyability, execution profile and recent trades.
- [Watchlist](https://docs.ballista.gg/terminal/watchlist.md): Star markets you want to keep an eye on, and review them in one place.