XXYY Trader

A BSC/SOL trending token scanner with automated trading, powered by the XXYY Open API. Automatically tracks the #1 trending token and executes buy/sell trades.

Install

npm install -g xxyy-trader

Usage

xxyy-trader start              # Start (auto-opens browser)
xxyy-trader stop               # Stop the server
xxyy-trader status             # Check running status
xxyy-trader autostart          # Enable auto-start on boot (Mac/Linux)
xxyy-trader autostart --disable # Disable auto-start

Getting Started

1. Run xxyy-trader start — the web UI opens automatically
2. Go to the Trade Strategy page
3. Enter your XXYY API Key (get one at xxyy.io/apikey)
4. Select a wallet from the dropdown
5. Set buy amount, slippage, and gas fee
6. Enable Rank-1 Tracking and save

Core Feature

Rank-1 Tracking: Scans the trending list every 2 seconds. Automatically buys the #1 token. When the top token changes, it sells the old one and buys the new one. Tokens that fall off the list are sold automatically.

Sell Strategy: This tool handles buying only. For selling, configure auto take-profit / stop-loss on the XXYY website:

• Take profit: sell 100% at +30%
• Stop loss: sell 100% at -50%

Supported Chains

• BSC (BNB Chain)
• Solana

Data Storage

All user data is stored in ~/.xxyy-trader/:

| File | Description | |------|-------------| | .env | Configuration | | scanner.db | SQLite database | | .secret | API key encryption key | | app.log | Application log |

Data persists across upgrades and reinstalls.

Requirements

• Node.js >= 18
• XXYY account and API Key

Disclaimer

This is an experimental tool for research and educational purposes. Cryptocurrency trading involves substantial risk. The authors are NOT responsible for any financial losses resulting from the use of this software. Use at your own risk.

License

MIT — see LICENSE for full terms and disclaimer.