⚡️ Argilac ⚡️

A crypto trading bot that automates trades based on TradingView alerts.

Setup Instructions

1. App Setup

1. Install Ngrok, create an account, and set up an auth token.
2. Create a .env file and add the following variables: MNEMONIC, ETHERSCAN_KEY, POLYGONSCAN_KEY, and API_KEY. Generate an api key by running yarn apiKey.
3. Create a chainData.json file based on the chainData.default.json file in the src/config folder.
4. Start the app by running yarn start, your dashboard should now be up and running at https://localhost:80.
5. Launch Ngrok with yarn ngrok to expose your server on port 80.

   Note: TradingView only accepts URLs with port numbers 80 and 443. More info here

6. Review and customize your preferences in the Control Panel section.

2. TradingView Alerts Setup

1. Open a chart with your desired token pair, select an indicator/strategy, and create buy/sell alerts.
2. In the "Settings" tab of each alert, add { type: "BUY", price: "{{close}}", apiKey: "YOUR_KEY" } for buy alerts and { type: "SELL", price: "{{close}}", apiKey: "YOUR_KEY" } for sell alerts.
3. In the "Notifications" tab, add the URL from your Ngrok output and append "/route" to the end.

3. Telegram Bot Setup (Optional)

1. Add @BotFather on Telegram and follow the prompts to obtain an API key.
2. Use "Telegram Bot Raw" to get your unique chat ID.
3. Add your API key as TELEGRAM_BOT_TOKEN and chat ID as TELEGRAM_CHAT_ID in your .env file.
4. The bot will send notifications for buys, sells, errors, and insufficient balance (out of gas) to Telegram. If you don't provide an API key or chat ID, Telegram notifications will be disabled.

4. Start the Bot and Profit!

1. Start the bot by toggling the switch in the Controls section of the Control Panel tab. You can now monitor for incoming trades in the Trades tab and see detailed error/event logs in the Logs tab. You can also see logs in the server output.

Note: Argilac currently only includes support for WETH, MATIC, USDC, and DAI on the Ethereum and Polygon mainnets and testnets. Additional tokens can be added in the config folder and in the ControlPanel component. Support for more tokens, chains, and DEXs coming soon.