{"id":24874585,"url":"https://github.com/fabohax/yaku","last_synced_at":"2026-01-22T08:34:10.328Z","repository":{"id":276889369,"uuid":"925073776","full_name":"fabohax/yaku","owner":"fabohax","description":"BTCUSD Signaler ","archived":false,"fork":false,"pushed_at":"2025-02-11T00:59:54.000Z","size":390,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-15T10:44:09.322Z","etag":null,"topics":["bitcoin","bot","okx","python","telegram","trading"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fabohax.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":"2025-01-31T07:08:23.000Z","updated_at":"2025-02-11T00:59:58.000Z","dependencies_parsed_at":"2025-02-11T01:32:23.178Z","dependency_job_id":"bb592597-7209-42d4-a2cf-bf22c00eb478","html_url":"https://github.com/fabohax/yaku","commit_stats":null,"previous_names":["fabohax/yaku"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fabohax/yaku","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabohax%2Fyaku","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabohax%2Fyaku/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabohax%2Fyaku/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabohax%2Fyaku/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fabohax","download_url":"https://codeload.github.com/fabohax/yaku/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabohax%2Fyaku/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28659518,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T01:17:37.254Z","status":"online","status_checked_at":"2026-01-22T02:00:07.137Z","response_time":144,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bitcoin","bot","okx","python","telegram","trading"],"created_at":"2025-02-01T07:27:45.616Z","updated_at":"2026-01-22T08:34:10.310Z","avatar_url":"https://github.com/fabohax.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp\u003e\n  \u003cimg src=\"yaku.png\" alt=\"yaku-bot\" width=\"400\" style=\"display: block; margin: auto;\"\u003e\n\u003c/p\u003e\n\n# yaku \n\n**yaku** is a high-performance cryptocurrency trading signaler bot built in Python. It follows a custom strategy called **Strato**, which is based on **MACD crossovers** and specific timing rules to maximize profitability.\n\n---\n\n## **Strato Strategy - Explained 🚀**\n\nThe **Strato** strategy is a systematic approach based on **MACD crossovers** with additional confirmations:\n\n1. **Bullish MACD Crossover**  \n   - A signal is triggered when the **MACD line crosses above the signal line**.\n   - This marks the start of an uptrend, where the bot begins monitoring price movement.\n\n2. **19-Minute Confirmation**  \n   - If **19 minutes** pass after the bullish crossover and price remains above the crossover level, a selling signal is issued.\n   - This prevents false signals caused by small fluctuations.\n\n3. **0.50% Target Price**  \n   - If the price rises **0.50% above the bullish crossover level**, the bot issues an alert.\n   - This ensures profit-taking at a reasonable gain before potential reversals.\n\n4. **Bearish MACD Crossover**  \n   - If the **MACD line crosses below the signal line**, a bearish crossover is detected.\n   - This serves as an early warning to reconsider market conditions.\n\n---\n\n## **Project Structure 📂**\n\n```\nyaku/\n│── bot.py               # Main signaler bot script\n│── config.py            # Configuration loader for API keys and bot settings\n│── go.sh                # Bash script to run the bot\n│── README.md            # Project documentation\n│── .env                 # Environment variables\n│── requirements.txt     # Python dependencies\n│── logs/                # Directory to store bot logs\n```\n\n---\n\n## **Installation \u0026 Setup 🔧**\n\n### **1. Install Python 🐍**\nMake sure Python 3.9 or higher is installed on your system. You can check with:\n```sh\npython3 --version\n```\n\n---\n\n### **2. Clone the Repository 📂**\n```sh\ngit clone https://github.com/fabohax/yaku.git\ncd yaku\n```\n\n---\n\n### **3. Set Up Dependencies 📦**\nInstall the required dependencies:\n```sh\npip install -r requirements.txt\n```\n\n---\n\n### **4. Set Up Environment Variables 🔑**\nCreate a `.env` file and add your **Telegram bot credentials**:\n\n```env\nTELEGRAM_BOT_TOKEN=your_telegram_token\nTELEGRAM_CHAT_ID=your_chat_id\n```\n\n---\n\n### **5. Run the Bot Using `go.sh` 🚀**\nYou can use the `go.sh` script to run the bot in the background and log the output:\n\nMake the script executable:\n```sh\nchmod +x go.sh\n```\n\nRun the script:\n```sh\n./go.sh\n```\n\nThe bot will start and log its output to `logs/bot.log`.\n\n---\n\n## **Deployment on a Server (VPS) 💻**\nTo run yaku 24/7, deploy it on a **VPS** or cloud server:\n\n1. **Install Python and Set Up Virtual Environment**\n   ```sh\n   sudo apt update \u0026\u0026 sudo apt install python3 python3-venv\n   python3 -m venv venv\n   source venv/bin/activate\n   pip install -r requirements.txt\n   ```\n\n2. **Run Using `go.sh`**\n   ```sh\n   ./go.sh\n   ```\n\n3. **Using `systemd` for Auto-Restart**\n   Create a new service file:\n   ```sh\n   sudo nano /etc/systemd/system/yaku.service\n   ```\n   Add the following:\n   ```ini\n   [Unit]\n   Description=yaku.signals\n   After=network.target\n\n   [Service]\n   ExecStart=/path/to/your/yaku/go.sh\n   Restart=always\n   User=your_user\n\n   [Install]\n   WantedBy=multi-user.target\n   ```\n\n   Enable and start the service:\n   ```sh\n   sudo systemctl enable yaku\n   sudo systemctl start yaku\n   ```\n\n---\n\n## **Future Improvements 🚧**\n- **Web Dashboard:** Monitor real-time signals.\n- **Backtesting Module:** Test the strategy on historical data.\n\n---\n\n## **Contributing 🤝**\nPull requests and issues are welcome! If you'd like to contribute, feel free to fork the repo and submit PRs.\n\n---\n\u003csub\u003e⚠ Warning: yaku is designed primarily for BTC/USDT due to its high liquidity and optimal volatility performance. Usage on other pairs may result in inconsistent signals. Always conduct your own risk assessment before trading. 🚀📊\u003c/sub\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabohax%2Fyaku","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffabohax%2Fyaku","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabohax%2Fyaku/lists"}