> ## 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. # Markets > Browsing by category, sorting, and the live crypto board. Markets is the terminal's front page and the only section you can use signed out. Everything Polymarket lists is here, as a grid of cards. ## Category chips The row along the top is the category filter. **All** is everything; **Crypto** is a board of its own, described below; the rest come from Polymarket's own tags. The row scrolls sideways when it does not fit. Point at it and use your scroll wheel, click the arrows that appear at either edge, or swipe it on a touchscreen — dragging it with a mouse does nothing. Picking a category replaces the current one; there is no multi-select. ## Sorts The dropdown to the right of the chips orders the grid four ways: | Sort | What it orders by | | --------------- | ----------------------------------------------------------------------- | | **Trending** | 24-hour volume, highest first. This is the default. | | **Volume** | All-time volume, highest first. | | **Newest** | Start date, most recent first. | | **Ending soon** | End date, soonest first — and it drops markets that have already ended. | The sort disappears in Crypto mode, which has an order of its own. ## What a card shows The event image and title, then the Yes price of up to four markets inside it. An event with more than four says how many more there are; an event with only one shows that market's price against the label "Yes". Total volume sits along the bottom. The star in the top right adds the event to your [Watchlist](/terminal/watchlist). It only appears when you are signed in. ## Infinite scroll The grid loads twenty-four events at a time and fetches the next page as you approach the bottom — there are no page numbers. When nothing matches you get "No markets found", quoting your search term back at you when you had one, rather than an empty grid. ## Crypto mode The **Crypto** chip switches to a purpose-built board for Polymarket's rolling "Up or Down" markets, grouped by how long each window runs: * **5 minute** — the fastest rolling markets * **15 minute** — short-term direction * **1 hour** — hourly direction * **1 day** — daily direction Each section shows one card per asset that has a market at that window: Bitcoin, Ethereum, Solana, XRP and Dogecoin. Not every asset runs at every window, so the sections are different lengths. A card carries the live Chainlink price for that asset, the window it covers, a countdown, and the current Up and Down prices. It is badged **LIVE** while its window is running and **NEXT** when the window has not started yet — and when the current window ends, the card moves on to the following one by itself. You never have to reload to keep up. Search does not apply in Crypto mode. Entering it clears whatever you had typed, because the board is a fixed set of markets rather than a query. Clicking any card opens the [market page](/terminal/market-page), which has its own crypto layout: the price to beat, the current price, and the live Chainlink chart for the window. ## What to read next What you get when you open one. Keeping the ones you care about to hand.