> ## 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.
# Presets
> Saving an order you place often, and firing it from a market page.
A preset is a saved order shape — type, side, size and price — that shows up on every
market page as a one-click chip. What presets are for is [Presets](/guides/presets);
this page is the terminal's screen for them.
They live under **Settings**.
## Sizes follow the side
**A buy preset holds a dollar amount. A sell preset holds a share count.** That is the
same rule the trade panel uses, and it applies to market and limit presets alike.
A limit buy is the one that converts: the preset stores your dollars, and when you fire
the chip it buys as many shares as that amount covers at the preset's price, rounded
down. The chip shows the dollar figure.
## The list
One row per preset: **Type** (limit or market), **Side**, **Size** and **Price**, with a
delete button on the right. Size shows as dollars or shares according to the side; a
market preset shows a dash for price.
A preset that cannot produce an order is labelled **Won't fire** on its row, with the
reason and the instruction to delete and recreate it. That is where a missing chip gets
explained — most often it is a preset made before sizes followed the side, holding its
size in the other column.
## Creating one
**New preset** opens a short dialog:
| Field | Notes |
| --------------- | -------------------------------------------------------------------------------------------------- |
| **Order type** | Limit or market. |
| **Side** | Buy or sell. Changing it clears the size, because the unit has changed. |
| **Size** | Labelled **Size (USDC)** on a buy and **Size (shares)** on a sell — one field, following the side. |
| **Price (0–1)** | Limit presets only. A probability: `0.42` is 42¢. |
For a limit buy, a line under the fields reminds you that it fires as an order for as
many shares as that dollar amount buys at that price, rounded down.
**Save preset** stays disabled until the preset can actually fire: at least \$0.01 or
0.01 shares, a tradable price on a limit preset, and — for a limit buy — a dollar amount
big enough to buy at least 0.01 shares at that price.
Prices are stored on the 1¢ tick the order book trades on. Enter an off-tick price
like `0.555` and the dialog says **Saved as 56¢** before you save it, so the chip, the
list and the order it fires all agree.
## Deleting one
The trash icon on its row. There is no confirmation and no undo.
## Editing
Presets cannot be edited in the terminal. To change one here, delete it and create a
replacement. Editing an existing preset in place is a Chrome extension feature —
see [the extension's Presets tab](/extension/presets-tab).
## Where they show up
On every market page, at the bottom of the trade panel, under **Quick orders**. Each
chip is labelled with exactly what it will do — `BUY $25 MKT`, `SELL 100 MKT`,
`BUY $25 @ 42¢ LIM` — and fires on click against the outcome currently selected in the
panel. See [Placing an order](/terminal/placing-orders).
The **Manage** link beside that heading brings you back here.
## What to read next
What presets are for, across all three surfaces.
Firing one from a market page.