{"id":50808135,"url":"https://github.com/nazmiefearmutcu/dive-into-crypto","last_synced_at":"2026-06-30T10:00:47.362Z","repository":{"id":360692423,"uuid":"1244599441","full_name":"nazmiefearmutcu/dive-into-crypto","owner":"nazmiefearmutcu","description":"Dive Into Crypto — a financial scanner for Binance USDT-M perpetual futures: 15 indicators across 12 timeframes, whale-microstructure divergence filtering, one consensus verdict per symbol. Native Android, runs on your device.","archived":false,"fork":false,"pushed_at":"2026-06-20T13:06:05.000Z","size":984,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-20T15:07:23.375Z","etag":null,"topics":["android","binance","compose-multiplatform","cryptocurrency","futures","kotlin","scanner","technical-analysis"],"latest_commit_sha":null,"homepage":null,"language":"Kotlin","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/nazmiefearmutcu.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-20T12:19:19.000Z","updated_at":"2026-06-20T13:05:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nazmiefearmutcu/dive-into-crypto","commit_stats":null,"previous_names":["nazmiefearmutcu/trading-bot","nazmiefearmutcu/cool-scanner","nazmiefearmutcu/dive-into-crypto"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/nazmiefearmutcu/dive-into-crypto","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nazmiefearmutcu%2Fdive-into-crypto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nazmiefearmutcu%2Fdive-into-crypto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nazmiefearmutcu%2Fdive-into-crypto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nazmiefearmutcu%2Fdive-into-crypto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nazmiefearmutcu","download_url":"https://codeload.github.com/nazmiefearmutcu/dive-into-crypto/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nazmiefearmutcu%2Fdive-into-crypto/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34961549,"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-30T02:00:05.919Z","response_time":92,"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":["android","binance","compose-multiplatform","cryptocurrency","futures","kotlin","scanner","technical-analysis"],"created_at":"2026-06-13T03:00:26.860Z","updated_at":"2026-06-30T10:00:47.356Z","avatar_url":"https://github.com/nazmiefearmutcu.png","language":"Kotlin","funding_links":[],"categories":["Trading \u0026 Backtesting"],"sub_categories":[],"readme":"# Dive Into Crypto\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Last commit](https://img.shields.io/github/last-commit/nazmiefearmutcu/dive-into-crypto)](https://github.com/nazmiefearmutcu/dive-into-crypto/commits)\n[![Stars](https://img.shields.io/github/stars/nazmiefearmutcu/dive-into-crypto?style=social)](https://github.com/nazmiefearmutcu/dive-into-crypto/stargazers)\n![Kotlin](https://img.shields.io/badge/Kotlin-7F52FF?logo=kotlin\u0026logoColor=white)\n![Python](https://img.shields.io/badge/Python-3776AB?logo=python\u0026logoColor=white)\n![React](https://img.shields.io/badge/React-149ECA?logo=react\u0026logoColor=white)\n\n**Dive Into Crypto is a financial scanner** for the entire Binance USDT‑M perpetual‑futures\nmarket. For every symbol it runs **15 technical indicators across 12 timeframes**, cross‑checks\nthe result against **whale (top‑trader) positioning**, and collapses everything into a single\nconfidence‑scored consensus verdict — long, short, or neutral. It reads only **public** Binance\nmarket data: no account, no API keys, no sign‑up.\n\nIt ships in **two editions** that share one consensus engine:\n\n| Edition | Stack | Data | Runs | Status |\n| --- | --- | --- | --- | --- |\n| **[📱 Android](android/)** | Kotlin · Jetpack Compose | Binance USDT‑M public REST + WS | On your device | Released — `v0.1.0` |\n| **[🖥️ Desktop](desktop/)** | Python (Crypcodile) + React terminal UI | Crypcodile‑fed, highest‑fidelity | Local, terminal‑launched | Released — `desktop-v0.1.0` |\n\n\u003e ⚠️ Dive Into Crypto is an analysis and research tool, **not financial advice** and **not an\n\u003e automated trader**. It places no orders. Markets are risky; you are responsible for your own decisions.\n\n---\n\n## The Desktop Edition\n\nA single‑window terminal‑themed desktop scanner. Real Binance USDT‑M data flows through\n[**Crypcodile**](https://github.com/nazmiefearmutcu/Crypcodile) (the open‑source market‑data\nengine) into the same canonical consensus engine the Android app uses — so the desktop verdicts\n**match Android exactly** (pinned by 30 parity tests). Three terminal themes: **Phosphor · Amber · Ice**.\n\n| Scanner — ranked market sweep | Panel — one symbol, in depth |\n| --- | --- |\n| ![Desktop scanner](docs/screenshots/desktop-scanner.png) | ![Desktop panel](docs/screenshots/desktop-panel.png) |\n\n### Run it\n\n```bash\ngit clone https://github.com/nazmiefearmutcu/dive-into-crypto.git\ncd dive-into-crypto/desktop/backend\nuv sync\nuv run dive-desktop          # starts the local service and opens the UI in your browser\n```\n\nThe UI is prebuilt and served by the local service; nothing leaves your machine except public\nBinance market‑data requests. Full details: **[desktop/README.md](desktop/README.md)**.\n\n---\n\n## The Android Edition\n\nNative Kotlin/Compose, runs entirely on your device, single signed APK. Install and usage:\n**[android/README.md](android/README.md)** · APK on the [latest release](../../releases/latest).\n\n---\n\n## The shared engine\n\nBoth editions implement the *same* consensus, pinned to one Python reference (the desktop reuses\nit directly; Android pins to it via 61 fixture tests).\n\n### 15 indicators\nEvery symbol × timeframe runs 15 independent indicators, each returning a five‑level signal\n(`STRONG_BUY = +2 … STRONG_SELL = −2`).\n\n| # | Indicator | Defaults | Family |\n| --- | --- | --- | --- |\n| 1 | RSI | period 14 | Oscillator |\n| 2 | Stochastic | %K 14, %D 3 | Oscillator |\n| 3 | Williams %R | period 14 | Oscillator |\n| 4 | CCI | period 20 | Oscillator |\n| 5 | MACD | 12 / 26 / 9 | Trend |\n| 6 | EMA cross | 9 / 21 | Trend |\n| 7 | SMA cross | 50 / 200 | Trend |\n| 8 | Ichimoku | 9 / 26 / 52 | Trend |\n| 9 | Parabolic SAR | AF 0.02 / 0.2 | Trend |\n| 10 | Bollinger Bands | 20, 2σ | Volatility |\n| 11 | MFI | period 14 | Volume |\n| 12 | OBV | SMA 20 | Volume |\n| 13 | ROC | period 12 | Momentum |\n| 14 | ADX + DI | period 14 | Trend strength |\n| 15 | ATR filter | period 14 | Volatility (filter, weight 0) |\n\n### Consensus\nA weighted vote (`weightedScore = Σ(signal × weight) / Σ(weight)`) with verdict thresholds\n(`≥1.2 STRONG_BUY · ≥0.4 BUY · ≤−0.4 SELL · ≤−1.2 STRONG_SELL`), a conflict override that forces\nNEUTRAL on too much disagreement, ADX‑driven regime adaptation, a 0–100 confidence score, and a\nLOW/MEDIUM/HIGH risk assessment.\n\n### Whale‑divergence filtering\nOn top of the indicators, Dive Into Crypto watches **top‑trader long/short positioning** and looks\nfor it to **diverge from price** (empirically contrarian, calibrated on real Binance observations).\nA symbol whose whale flow contradicts its indicator verdict is **eliminated** from the ranking and\nback‑filled by the next clean survivor. The 12 timeframes are\n`1m · 3m · 5m · 15m · 30m · 1h · 2h · 4h · 6h · 8h · 12h · 1d`.\n\n---\n\n## Data sources\n\nPublic Binance USDT‑M Futures endpoints only — no authentication.\n\n| Data | Endpoint |\n| --- | --- |\n| Candles (OHLCV) | `fapi.binance.com/fapi/v1/klines` |\n| Open interest history | `fapi.binance.com/futures/data/openInterestHist` |\n| Top‑trader L/S (positions / accounts) | `fapi.binance.com/futures/data/topLongShort*Ratio` |\n| Global L/S (accounts) | `fapi.binance.com/futures/data/globalLongShortAccountRatio` |\n| Taker buy/sell ratio | `fapi.binance.com/futures/data/takerlongshortRatio` |\n| Funding / mark / index | `fapi.binance.com/fapi/v1/premiumIndex`, `…/fundingRate` |\n\n\u003e Binance market data may be geo‑restricted in some regions; that is a network/runtime condition\n\u003e independent of the app.\n\n---\n\n## Repository layout\n\n```\ndive-into-crypto/\n├─ android/    # native Kotlin/Compose edition (Gradle)\n├─ desktop/    # Python (Crypcodile) backend + React terminal UI\n└─ docs/       # specs, plans, screenshots\n```\n\n---\n\n## Disclaimer\n\nDive Into Crypto is an educational and research tool. It does not give financial advice, it does\nnot execute trades, and it makes no guarantee of accuracy or profitability. Cryptocurrency\nderivatives are high‑risk. Use it at your own risk.\n\n## License\n\n[MIT](LICENSE) © nazmiefearmutcu\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnazmiefearmutcu%2Fdive-into-crypto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnazmiefearmutcu%2Fdive-into-crypto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnazmiefearmutcu%2Fdive-into-crypto/lists"}