> For the complete documentation index, see [llms.txt](https://farside.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://farside.gitbook.io/docs/readme.md).

# README

> Need help?\
> If you have questions, issues, or need support, please open a ticket in our Discord support server:\
> [\[Discord\]](https://discord.gg/farside)

Farside Trading is a platform for creating, testing, running, and monitoring automated trading bots.

It is built for users who want one place to:

* connect a wallet
* create or select a trading account
* prepare an exchange or paper account
* create bots with strategy and risk settings
* test bots with paper trading or backtesting
* run live bots when they are ready
* monitor status, orders, positions, profit and loss, and alerts

The docs are written for platform users. They avoid developer details and focus on what you can see and do in the product.

## What automated trading bots do

A trading bot follows configuration you choose. It watches markets, checks strategy conditions, applies risk controls, and may place or manage orders when the setup allows it.

A bot does not guarantee profit. A bot can wait without trading, open losing trades, stop because of a safety check, or enter safe mode when something needs attention.

## Paper trading, testnet, and live trading

Farside supports different ways to use the platform:

| Mode           | What it means                                                     | Real money risk                                                              |
| -------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Paper trading  | Simulated trading inside Farside using a paper execution context. | No live order risk, but results can differ from live trading.                |
| Testnet        | Exchange test environment where supported.                        | Usually not real money, but setup still needs to match the selected account. |
| Live / mainnet | Real trading on a connected exchange account.                     | Yes. You can lose money.                                                     |
| Backtesting    | Runs a saved bot over historical market data.                     | No live order risk, but past results do not predict future results.          |

If you are new, start with paper trading or backtesting before using live trading.

## Main platform flow

The normal user flow is:

1. Connect wallet.
2. Get admitted if beta/public access requires it.
3. Create or select an execution account.
4. Finish venue readiness.
5. Create a bot.
6. Review strategy, leverage, and risk.
7. Start in paper mode or run a backtest.
8. Monitor behavior.
9. Go live only after you understand the risks.

## Supported venues

The current user-facing venues are:

* Hyperliquid
* dYdX
* Paper

Paper is not an exchange. It is Farside's simulated trading mode.

## Supported bot strategies

The current user-selectable bot strategies are:

* Trend (V2 Structural), shown in config as `v2_structural`
* Mean Reversion, shown in config as `mean_reversion`
* Grid, shown in config as `grid`

Legacy trend bots may appear on older saved bots, but new users should use the current strategy choices shown in the product.

## Risk responsibility

You are responsible for your trading decisions, configuration choices, leverage, account funding, and whether you run bots live.

Farside can provide workflow guardrails and warnings, but it cannot remove trading risk.

Read [Risk Notice](https://github.com/Vallisalpes-com/farside-trading-dashboard/blob/stag/docs/risk-notice.md), [Leverage and Risk](https://github.com/Vallisalpes-com/farside-trading-dashboard/blob/stag/docs/leverage-and-risk.md), and [Safety Before You Go Live](https://github.com/Vallisalpes-com/farside-trading-dashboard/blob/stag/docs/guides/safety-before-you-go-live.md) before live trading.

## Where to go next

* [Quickstart](https://github.com/Vallisalpes-com/farside-trading-dashboard/blob/stag/docs/quickstart.md)
* [Getting Started](https://github.com/Vallisalpes-com/farside-trading-dashboard/blob/stag/docs/getting-started.md)
* [Dashboard and Navigation](https://github.com/Vallisalpes-com/farside-trading-dashboard/blob/stag/docs/dashboard-navigation.md)
* [Bot Configuration Glossary](https://github.com/Vallisalpes-com/farside-trading-dashboard/blob/stag/docs/bot-configuration-glossary.md)
* [Notifications](https://github.com/Vallisalpes-com/farside-trading-dashboard/blob/stag/docs/notifications.md)
* [Troubleshooting](https://github.com/Vallisalpes-com/farside-trading-dashboard/blob/stag/docs/troubleshooting.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://farside.gitbook.io/docs/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.