Local Setup

Token Splash Farmer is a lightweight, single‑page control panel for fee‑aware microscalping. This guide covers local setup.

Requirements

• Python 3.10+
• Bybit API key + secret (spot or perps)
• Optional: sub‑account keys for group mode

Install & Run

cd /path/to/TokenSplashFarmer
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python server.py

Open: http://127.0.0.1:8088

Configure .env

Copy .env.example to .env and fill in your keys:

BYBIT_API_KEY=...
BYBIT_API_SECRET=...
BYBIT_API_URL=https://api.bybit.com
BYBIT_CATEGORY=spot

Optional limits & safety:

TSF_ACCOUNT_TTL_HOURS=1
TSF_MAX_ACCOUNTS=8
TSF_MAX_SYMBOLS=20
TSF_DAILY_RESTART=1
TSF_ACCOUNT_PASSWORD=your_remove_password

Add Accounts

• Use sub‑accounts or keys without withdrawal permission.
• Add accounts in the Accounts panel.
• Switch active account via the dropdown.

Add Symbols & Start

• Add symbols in Config.
• Apply settings to selected/all.
• Click Start to run.

Notes

• On a server (EC2), use systemd to auto‑restart.
• Secrets are masked in the UI and stored in server memory only.

Troubleshooting

• client not configured: check keys + category.
• 403 errors: check IP whitelist on Bybit API key.
• No fills: verify symbol, balance, and mode.