{"id":50708079,"url":"https://github.com/meiiie/hinto-trader","last_synced_at":"2026-06-09T13:02:00.108Z","repository":{"id":356880927,"uuid":"1234441791","full_name":"meiiie/hinto-trader","owner":"meiiie","description":"Local-first crypto futures trading engine with FastAPI, React, Tauri, backtesting, and paper-mode safety defaults.","archived":false,"fork":false,"pushed_at":"2026-05-22T16:18:10.000Z","size":6091,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-22T16:45:04.288Z","etag":null,"topics":["algorithmic-trading","backtesting","binance-futures","crypto","fastapi","hinto","python","react","risk-management","tauri","trading-bot"],"latest_commit_sha":null,"homepage":null,"language":"Python","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/meiiie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-10T07:31:36.000Z","updated_at":"2026-05-10T14:40:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/meiiie/hinto-trader","commit_stats":null,"previous_names":["meiiie/hinto-trader"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/meiiie/hinto-trader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meiiie%2Fhinto-trader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meiiie%2Fhinto-trader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meiiie%2Fhinto-trader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meiiie%2Fhinto-trader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/meiiie","download_url":"https://codeload.github.com/meiiie/hinto-trader/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meiiie%2Fhinto-trader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34107866,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"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":["algorithmic-trading","backtesting","binance-futures","crypto","fastapi","hinto","python","react","risk-management","tauri","trading-bot"],"created_at":"2026-06-09T13:02:00.027Z","updated_at":"2026-06-09T13:02:00.102Z","avatar_url":"https://github.com/meiiie.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/header.png\" alt=\"Hinto\" width=\"100%\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eLocal-first crypto futures trading engine with backtesting, paper mode, live monitoring, and a Tauri desktop dashboard.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e |\n  \u003ca href=\"#screenshots\"\u003eScreenshots\u003c/a\u003e |\n  \u003ca href=\"#architecture\"\u003eArchitecture\u003c/a\u003e |\n  \u003ca href=\"#quick-start\"\u003eQuick Start\u003c/a\u003e |\n  \u003ca href=\"#safety\"\u003eSafety\u003c/a\u003e |\n  \u003ca href=\"#strategy-direction\"\u003eStrategy Direction\u003c/a\u003e |\n  \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/version-0.2.1-blue?style=flat-square\" alt=\"Version\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/python-3.11+-yellow?style=flat-square\u0026logo=python\u0026logoColor=white\" alt=\"Python\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/FastAPI-backend-009688?style=flat-square\" alt=\"FastAPI\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/React-dashboard-61dafb?style=flat-square\u0026logo=react\u0026logoColor=222\" alt=\"React\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Tauri-desktop-24c8db?style=flat-square\u0026logo=tauri\u0026logoColor=white\" alt=\"Tauri\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-lightgrey?style=flat-square\" alt=\"License\" /\u003e\n\u003c/p\u003e\n\n---\n\n## Overview\n\n**Hinto** is a research-grade trading system for Binance Futures. It keeps the\ncore trading logic local, tracks signals away from the exchange, and executes\nonly when a tracked signal is triggered. The project includes:\n\n- A FastAPI backend for market data, signal generation, execution, settings,\n  analytics, and WebSocket updates.\n- A React + Tauri dashboard for monitoring signals, positions, backtests, and\n  live state.\n- A backtesting engine tuned for closer live parity with 1m monitoring,\n  candle-close stop validation, and realistic execution assumptions.\n- Guardrails for paper/testnet-first operation, secret handling, and public\n  release hygiene.\n\nHinto is open-sourced as a codebase and research platform. It is not financial\nadvice, a profit guarantee, or a plug-and-play money machine.\n\n## Features\n\n| Area | What Hinto Provides |\n| --- | --- |\n| Local-first execution | Signals are stored locally and only become orders when price triggers. |\n| Strategy engine | Liquidity-zone style signal generation, confluence scoring, delta divergence, and multi-timeframe trend filters. |\n| Risk controls | Candle-close stop loss, hard-cap protection, exchange backup stops, global drawdown halt, and dead-zone windows. |\n| Backtesting | Historical simulation with 1m monitoring, configurable leverage, max positions, stop logic, and execution mode. |\n| Dashboard | React/Tauri interface for charts, portfolio state, signal logs, settings, and backtest views. |\n| Persistence | SQLite repositories for signals, orders, positions, settings, and analytics. |\n| Notifications | Telegram notification support for system and trade events. |\n| Public safety | `.env.example` templates, tracked-file secret scanning, ignored local secrets, and paper mode defaults. |\n\n## Screenshots\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/screenshots/hinto-desktop-chart.png\" alt=\"Hinto desktop chart with signal panel\" width=\"100%\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/screenshots/hinto-mobile-chart.png\" alt=\"Hinto mobile chart layout\" width=\"320\" /\u003e\n\u003c/p\u003e\n\n## Architecture\n\n```mermaid\nflowchart LR\n    ws[\"Binance WebSocket\"] --\u003e shared[\"Shared Binance Client\"]\n    shared --\u003e signal[\"Signal Generator\"]\n    signal --\u003e shark[\"Shark Tank Coordinator\"]\n    shark --\u003e live[\"Live Trading Service\"]\n    live --\u003e monitor[\"Position Monitor\"]\n    monitor --\u003e rest[\"Binance REST API\"]\n    live --\u003e db[\"SQLite Repositories\"]\n    live --\u003e tg[\"Telegram Notifications\"]\n    db --\u003e api[\"FastAPI\"]\n    api --\u003e ui[\"React + Tauri Dashboard\"]\n```\n\nThe backend follows a layered structure:\n\n| Layer | Path | Responsibility |\n| --- | --- | --- |\n| API | `backend/src/api` | HTTP/WebSocket endpoints and request schemas. |\n| Application | `backend/src/application` | Trading, backtesting, signal, risk, and orchestration services. |\n| Domain | `backend/src/domain` | Entities, interfaces, value objects, and repository contracts. |\n| Infrastructure | `backend/src/infrastructure` | Binance clients, persistence, indicators, notifications, execution queues. |\n| Frontend | `frontend/src` | Desktop dashboard, charts, settings, and monitoring views. |\n\n## Quick Start\n\nClone and configure:\n\n```powershell\ngit clone https://github.com/meiiie/hinto-trader.git\ncd hinto-trader\nCopy-Item .env.example .env\n```\n\nThe default `.env.example` uses `ENV=paper` with `HINTO_PAPER_REAL=true`.\nThis keeps live Binance market data and a live-like dashboard while orders and\nfills stay in the local simulator. Keep this mode while validating strategy\nbehavior; see `docs/PAPER_REAL_MODE.md`.\n\nRun the backend:\n\n```powershell\ncd backend\npython -m venv .venv\n.\\.venv\\Scripts\\Activate.ps1\npip install -r requirements.txt\npython run_backend.py\n```\n\nRun the dashboard:\n\n```powershell\ncd frontend\nnpm ci\nnpm run dev\n```\n\nBuild the dashboard:\n\n```powershell\ncd frontend\nnpm run build\n```\n\nRun the tracked-file secret scan:\n\n```powershell\npowershell -NoProfile -ExecutionPolicy Bypass -File .\\scripts\\secret-scan.ps1\n```\n\n## Configuration\n\nHinto reads runtime configuration from environment files and local settings.\nNever commit real credentials.\n\n| File | Purpose |\n| --- | --- |\n| `.env.example` | Root template for paper/testnet/live settings. |\n| `backend/.env.example` | Backend-specific Binance/testnet template. |\n| `frontend/.env.example` | Dashboard API/WebSocket endpoint template. |\n| `SECURITY.md` | Secret-handling and reporting guidance. |\n\n## Safety\n\nTrading software can lose money quickly, especially with leverage. Treat Hinto\nas research infrastructure unless you have audited the code, the configuration,\nand the exchange behavior yourself.\n\n- Start with `ENV=paper`.\n- Use Binance testnet before live credentials.\n- Rotate any key that has ever been copied into a repository, chat, screenshot,\n  or log.\n- Do not commit `.env`, `.env.production`, PEM files, databases, generated CSVs,\n  or local logs.\n- Run `scripts/secret-scan.ps1` before every public release.\n\n## Strategy Direction\n\nHinto is being developed as a research platform before it is treated as a live\ntrading system. The current mean-reversion scalper is now a benchmark track, not\na final answer. The next research track focuses on positive-skew continuation:\nsmall controlled losses, larger trailed winners, and validation by R-multiple\ndistribution rather than headline win rate.\n\nSee `docs/STRATEGY_ROADMAP.md` for promotion/kill criteria, broker expansion\nrules, and the clean-architecture path for adding new strategies.\n\n## Repository Status\n\nThis public repository starts from a cleaned source snapshot. Private deployment\nhistory, local logs, old agent folders, generated build outputs, and archived\nresearch scratch files were intentionally left out.\n\n## Contributing\n\nContributions are welcome. Please read `CONTRIBUTING.md` before opening an\nissue or pull request.\n\nGood first areas:\n\n- Safer defaults and clearer configuration validation.\n- Backtest/live parity tests.\n- Dashboard usability and accessibility.\n- Documentation for paper/testnet workflows.\n- Exchange adapter abstractions.\n\n## License\n\nMIT License. See `LICENSE`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeiiie%2Fhinto-trader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmeiiie%2Fhinto-trader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeiiie%2Fhinto-trader/lists"}