CEX & DEX integration with multi messaging platform support (Telegram, Matrix and Discord). Place order for CEFI or DEFI exchanges, query balance and quote ticker. Deploy it via docker on selfhosted platform or PaaS.

If you like it, feel free to

1. Create your channel/room and your platform bot

   • Telegram via Telegram @BotFather if you use Telethon create an api key
   • Discord via Discord Dev Portal
   • Matrix via Matrix.org

2. Get your

   • CEX API Keys supported by CCXT or
   • DEX keys and RPC supported by Web3. You can use chainlist, awesome rpc list or cointool for chain/RPC details

3. Update the config (bot token, bot channel and exchange details). Point or copy your config db.json to the volume /code/config)

4. Deploy via:

   • docker docker push mraniki/tt:latest or docker pull ghcr.io/mraniki/tt:latest
   • locally git clone https://github.com/mraniki/tt:main && pip install -r requirements.txt

5. Start your container or if deployed locally use python3 bot.py to start

6. More details in Wiki

Quick start approach: Update the sample db with your parameters and save it as db.json. If you deploy the bot on a PaaS cloud platform, you can use DB_URL environment variable to import db.json from a secure location. MOre detail on the config: https://github.com/mraniki/tt/wiki/Configuration

DB sample

env sample

• sell BTCUSDT sl=6000 tp=4500 q=1% or sell BTCUSDT Order processing (direction symbol sl=stoploss tp=takeprofit q=percentagequantity% or direction symbol)
• /bal Query user account exchange balance
• /cex name or /dex name Switch between any CEX or DEX (e.g /cex kraken, /dex pancake)
• /trading Disable or Enable trading
• /testmode Switch between testnet,sandbox or mainnet
• /q BTCB Retrieve ticker quote and token information from exchange and coingecko

• Enable bot in Telegram (ptb v20 and telethon), Matrix (simplematrixbotlib) and Discord (pycord) messaging platform
• Place order for CEX and DEX, Query Balance and quote ticker
• Push your order signal manually or from system like trading view webhook alert. Verified with Binance, Binance Testnet, FTX😠, Kraken, Huobi, BSC & pancakeswap, polygon and quickswap). If SL / TP or QTY are missing values are defaulted
• Support DEX automatic token approval
• Support uniswap v2 and 1inch api
• Support % of stablecoin balance when placing order

• Support bot in private channel and multiple channel per environment
• Support multiple environment via variable (e.g. DEV, PRD, PRD CEX, UNI1 or UNI2)
• Handle libraries exceptions in one function and notification delivery with apprise
• Enable dev and main branches with auto release and docker deployment pipeline setup for continueous deployment in dockerhub
• Support all messaging bot as asynchrousnous process
• Support common notification via Apprise for all nessaging platform
• Support deployment on PaaS or selfhosting
• Support config folder and config file in the dockerfile to automatically create the volume folder and its config
• Support config file as variable to deploy on PaaS (tested with northflank, koyeb, GKE, render and fly.io)
• Create DB if it is missing and check bot variables for failover
• Support bot restart capability
• Support contract with standard json tokenlist.org vetted tokenlist, personal list for testnet (example)
• Support coingecko API as backup of tokenlist for contract search
• Configure the default exchange and default test mode when starting the bot.
• Support multiple messaging platform (Telegram, Matrix and Discord)
• Include healthcheck, webhook and notify capability via FastAPI webserver on port 8080 with build-in JSON API swagger

Wiki

more screenshots

🚧 Roadmap

• Refactoring of more complex functions

• Support Uniswap V3
• Support limit order for DEX (1inch) and review feasibility for dydx / GMX
• Review testmode command to be part of the switch command

• Support limit order for DEX (Uniswap v3)
• Support futures and margin for CEX (to be tested via CCXT)
• Support STOPLOSS TAKEPROFIT for CEX
• Support multiple TAKEPROFIT target for CEX
• View free margin for futures in /bal
• View opened position via /pos (futures and limit order)

• Create / modify db via bot chat nested conversation
• Review DEX private key strategy (walletconnect authentification via pywalletconnect)
• Support Web3 ENS
• View daily pnl in /bal
• View weekly pnl with /w command and scheduling

• Merge with MQL4 version for MT4 TradFi support

This is an education tool and should not be considered professional financial investment system nor financial advice. Use a testnet account or USE AT YOUR OWN RISK. For DEX, Never share your private keys.

NEVER use your main account for automatic trade