{"id":18881630,"url":"https://github.com/alakise/yurttraders","last_synced_at":"2026-04-10T00:32:53.945Z","repository":{"id":248719749,"uuid":"829480611","full_name":"alakise/YurtTraders","owner":"alakise","description":"YurtTraders is an advanced cryptocurrency trading bot with Web UI that scrapes Telegram channels that supports ETH, BNB, AVAX and more...","archived":false,"fork":false,"pushed_at":"2024-07-16T16:47:28.000Z","size":10462,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-31T03:27:54.293Z","etag":null,"topics":["avax","bnb-chain","ethereum","flask","python","scrapper-bot","telegram","telegram-bot","trade-bot","vuejs","web3"],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alakise.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-16T14:09:03.000Z","updated_at":"2024-12-25T23:45:41.000Z","dependencies_parsed_at":"2024-07-16T19:00:06.981Z","dependency_job_id":null,"html_url":"https://github.com/alakise/YurtTraders","commit_stats":null,"previous_names":["alakise/yurttraders"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alakise%2FYurtTraders","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alakise%2FYurtTraders/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alakise%2FYurtTraders/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alakise%2FYurtTraders/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alakise","download_url":"https://codeload.github.com/alakise/YurtTraders/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239850446,"owners_count":19707348,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["avax","bnb-chain","ethereum","flask","python","scrapper-bot","telegram","telegram-bot","trade-bot","vuejs","web3"],"created_at":"2024-11-08T06:50:32.335Z","updated_at":"2025-12-30T20:16:52.121Z","avatar_url":"https://github.com/alakise.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# YurtTraders\n![Wallets Tab](imgs/wallets-tab-screenshot.png)\nYurtTraders is an advanced cryptocurrency trading bot that scrapes Telegram channels for real-time market intelligence and automated trading execution across multiple blockchain networks. However, I initally wrote it for myself just for BNB Chain use. Then my friends wanted to use it and I removed some hardcodded values and made it more user friendly. The thing is I have no time to main this project anymore and I think it contains many useful codes that many people can reuse. Feel free to add stuff.\n\n☢️ THE CODE IS VERY MESSY, SORRY ABOUT THAT ☢️\nThis project actually started as a short python script. I have never intented to complicate things this much but we were in best times of blockchain and made a bank thanks to this project. So I developed it, added many features so fast and kind of lost the discipline.\n\n## Table of Contents\n\n1. [Features](#features)\n2. [Project Structure](#project-structure)\n3. [Installation](#installation)\n4. [Configuration](#configuration)\n5. [Usage](#usage)\n6. [Telegram Integration](#telegram-integration)\n7. [Trading Capabilities](#trading-capabilities)\n8. [Security Considerations](#security-considerations)\n9. [Contributing](#contributing)\n10. [Disclaimer](#disclaimer)\n11. [License](#license)\n\n## Features\n\n- Multi-network support (BSC, Ethereum, Avalanche, etc.)\n- Automated Telegram channel monitoring\n- Intelligent message analysis and token detection\n- Configurable trading parameters\n- Multi-wallet management\n- Web-based control panel\n- Honeypot detection\n- Customizable gas strategies\n\n\n## Project Structure\n```\n.\n├── data/\n│   ├── doge_factory.json\n│   ├── doge_router.json\n│   ├── etc_factory.json\n│   ├── etc_router.json\n│   ├── pair_abi.json\n│   ├── TJ_factory.json\n│   ├── TJ_router.json\n│   ├── token_abi.json\n│   ├── uni_factory.json\n│   └── uni_router.json\n├── sessions/\n├── static/\n├── users/\n├── venv/\n├── yurt-traders-client/\n├── app.py                     # Main Flask app\n├── bot_relations.py           # Handles bot relationships\n├── bsc_blockchain.py          # BSC blockchain interactions\n├── cipher.py                  # Encryption and decryption operations\n├── config.py                  # Configuration file\n├── connection.py              # Connection management\n├── database.py                # Database operations\n├── operations.py              # General operations\n├── telegram_bot.py            # Telegram bot script\n├── user.py                    # User-related operations\n└── wallet.py                  # Wallet-related operations\n```\n\n\n## Installation\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/yourusername/yurttraders.git\n   cd yurttraders\n   ```\n\n2. Create a virtual environment:\n   ```\n   python -m venv venv\n   source venv/bin/activate  # On Windows use `venv\\Scripts\\activate`\n   ```\n\n3. Install dependencies:\n   ```\n   pip install -r requirements.txt\n   ```\n4. Set enviroment variables in root directory '.env':\n    ```\n    TELEGRAM_API_ID = \"\"\n    TELEGRAM_API_HASH = \"\"\n    ```\n5. Run the application:\n   ```\n   python app.py\n   ```\n\n\n## Configuration\n\nAdditional configuration is done through the web interface after launching the application.\n\n## Usage\n\n1. Access the web interface at `http://localhost:3059` (default port)\n2. Log in or create an account\n3. Configure network settings, Telegram groups, and trading parameters\n4. Telegram will send a verification code enter the code USING TERMINAL\n4. Start the bot and monitor its activity through the dashboard\n\n## Telegram Integration\n\nYurtTraders offers sophisticated Telegram integration features:\n\n### Blacklist and Whitelist Filtering\n- **Blacklist**: Prevents the bot from reacting to messages containing specific blacklisted words.\n- **Whitelist**: Ensures the bot only reacts to messages containing specific whitelisted words.\n\n### Group Monitoring and Signal Detection\n- **Listening to Multiple Groups**: The bot can monitor multiple Telegram groups simultaneously.\n- **Recursive Message Analysis**: Performs recursive searches within group history to find relevant contract addresses or links.\n\n### Automated Group Joining\n- **Public and Private Group Links**: Detects and joins new groups via public or private Telegram invite links.\n- **Recursive Searches in Joined Groups**: Performs recursive searches within newly joined groups.\n\n### Message Handling and Decryption\n- **Morse Code and XOR Decryption**: Handles and decrypts messages encoded in Morse code or XOR encryption.\n- **Important Message Detection**: Triggers alerts for messages containing high-priority keywords.\n\n### Writing Buy Settings for Telegram Groups\n\nThe `listen` string contains the parameters for the Telegram groups the bot should monitor. Each group can have specific buy settings, formatted as follows:\n\n#### Format\n```\ngroup_link*param1*param2*...*paramN\n```\n\n#### Parameters\n- **multi**: Enables multi-wallet trading.\n- **alarm**: Triggers an alarm for important messages.\n- **any**: Buys tokens from any message.\n- **max**: Sets a maximum transaction limit.\n- **single**: Buys only a single token from the group.\n- **honeypot**: Enables honeypot checks.\n- **1p**: Buys up to 1% of the token's supply.\n- **quarterp**: Buys up to 0.25% of the token's supply.\n- **portal**: Enables portal mode for message processing.\n- **mcap=X**: Sets a market cap limit of `X`.\n- **wallets=X**: Specifies the number of wallets to use.\n\n#### Example\n```\nhttps://t.me/group1*2x0.01*mcap=35000*any*alarm*multi\nhttps://t.me/group2*1x0.05*honeypot*wallets=2*multi\n```\n\n\n### Session Management\n- **Session Persistence**: Saves and loads Telegram sessions to maintain connectivity across restarts.\n\n## Trading Capabilities\n\nYurtTraders provides advanced trading features:\n\n- **Automated Buy and Sell Orders**: Executes trades based on detected signals and predefined strategies.\n- **Market Cap Analysis**: Evaluates token market capitalization before trading.\n- **Honeypot Detection**: Checks for potential scams or honeypot contracts.\n- **Multi-Wallet Support**: Manages and trades from multiple wallets for distributed risk.\n- **Customizable Gas Strategies**: Allows fine-tuning of gas prices for optimal trade execution.\n\n\n### Wallets Tab\n- **Set Mnemonics**: Allows users to input their 12-key mnemonics to configure their wallets.\n- **Wallets Management**: Displays the list of wallets, their addresses, and balances. Users can refresh wallets and manage multiple wallets.\n- **Transfers**: Enables users to distribute or collect balances across wallets and specify the amount to transfer.\n\n![Wallets Tab](imgs/wallets-tab-screenshot.png)\n\n### Settings Tab\n- **Network Settings**: Configure network options such as network type, API tokens, RPC URLs, and gas settings.\n- **Telegram Settings**: Manage Telegram settings, including whitelist and blacklist keywords and scanner orders.\n\n![Settings Tab](imgs/settings-tab-screenshot.png)\n\n### Token Interaction Tab\n- **Token Analysis**: Input a token address to analyze it.\n- **Approval**: Approve tokens for trading, with options for balance checks.\n- **Sell**: Specify wallets and amounts to sell tokens.\n- **Sniper**: Configure and execute sniper buy settings, including buy amount, wallets, and repeat settings.\n\n![Token Interaction Tab](imgs/token-interaction-tab-screenshot.png)\n\n\n## Security Considerations\n\n- User credentials and wallet keys are stored with encryption\n- Telegram sessions use MTProto encryption\n- The web interface requires authentication\n- Private keys are never transmitted off the device\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the project\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## Disclaimer\n\nThis software is for educational purposes only. Cryptocurrency trading carries significant risks. Use at your own discretion and always conduct thorough research before trading.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falakise%2Fyurttraders","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falakise%2Fyurttraders","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falakise%2Fyurttraders/lists"}