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

# Getting help

> Where to ask, what to include, and what never to send.

<Warning>
  Never share your private key. Not with support, not in a Discord channel, not
  in a direct message from someone offering to fix your account. Nobody at
  Ballista will ever ask for it, and no legitimate troubleshooting needs it. See
  [Your wallet and keys](/guides/wallet-and-keys).
</Warning>

## Where to ask

There are two routes, both reachable from the footer of the Ballista website:

* **Email — [admin@ballista.gg](mailto:admin@ballista.gg)**. Use this for
  anything specific to your account, and for anything you would rather not post
  in public.
* **Discord** — the community server. The invite is in the site footer and on
  the extension's download page. Best for questions that are not
  account-specific.

Start from the site rather than from a link someone sent you; the footer is
where the current invite lives.

<Info>
  Only follow Ballista links from the official site or from the bot you already
  registered with. Impersonation is common in prediction-market communities, and
  an account that DMs you first is a bad sign.
</Info>

## What to include

The more of this you give up front, the fewer round trips it takes:

* **Which surface** — Telegram bot, web terminal or Chrome extension. Behaviour
  differs between them and it is the first thing anyone will ask.
* **What you were doing** — "placing a limit buy", "creating a copy trade",
  "opening the deposit dialog".
* **The exact error text.** Ballista's messages are specific on purpose; "it
  didn't work" loses all of the information the message was carrying.
* **Roughly when it happened**, with a timezone.
* **The market**, if it is about an order — a link or a slug.
* **The target wallet**, if it is about a copy trade or a backtest.

## Check these first

A lot of reports resolve into something already documented:

<AccordionGroup>
  <Accordion title="The terminal or extension says my account was not found">
    You have not registered yet. Accounts are created only in the Telegram bot —
    see [Create your account](/guides/create-account).
  </Accordion>

  <Accordion title="My order was rejected for size">
    Orders under about a dollar round to zero at the exchange. See
    [Limits](/guides/limits).
  </Accordion>

  <Accordion title="My limit order went in at a different price">
    Limit prices are placed in whole cents and snapped to the nearest one. See
    [Placing orders](/guides/orders).
  </Accordion>

  <Accordion title="I cannot find the withdraw button">
    There isn't one. Export your key and withdraw through Polymarket — see
    [Your wallet and keys](/guides/wallet-and-keys).
  </Accordion>

  <Accordion title="I cannot sell from the Telegram bot">
    You cannot — the bot is buy-only. Close positions from the web terminal or
    the Chrome extension. See [Placing orders](/guides/orders).
  </Accordion>

  <Accordion title="A feature I read about is missing">
    Coverage is uneven across the three surfaces on purpose. The table in
    [What Ballista does not do](/guides/what-ballista-does-not-do) says which
    surface has what.
  </Accordion>

  <Accordion title="My exported key shows an empty wallet">
    Expected. The key is the signing address; your balance is in the Polymarket
    proxy wallet it controls. See [Your wallet and keys](/guides/wallet-and-keys).
  </Accordion>

  <Accordion title="A statistic on a trader shows a dash">
    A dash means unmeasured, not zero, and the interface says what would fill it
    in. See [Trader profiles](/guides/trader-profiles).
  </Accordion>
</AccordionGroup>

## What support cannot do

Ballista places your orders on Polymarket; it does not run the market. Nobody
can reverse a fill, change how a market resolved, refund a deposit, or recover
funds sent to a wrong address on the wrong chain. Those are properties of the
exchange and of the blockchain, not settings.

## What to read next

<CardGroup cols={2}>
  <Card title="What Ballista does not do" icon="ban" href="/guides/what-ballista-does-not-do">
    Most "is this broken?" questions are answered here.
  </Card>

  <Card title="Limits" icon="ruler" href="/guides/limits">
    The bounds that produce the most common error messages.
  </Card>
</CardGroup>