pybynix 1.0.0__tar.gz

pybynix-1.0.0/.env.example

@@ -0,0 +1,5 @@
+BYNIX_EMAIL=your-email@example.com
+BYNIX_PASSWORD=replace-locally
+# Or provide a current session token instead:
+# BYNIX_TOKEN=replace-locally
+BYNIX_HOST=bynixbrokers.com

pybynix-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: checks
+on: [push, pull_request]
+permissions:
+  contents: read
+concurrency:
+  group: checks-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  test:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python: ['3.11', '3.13']
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python }}
+      - run: python -m pip install --upgrade pip
+      - run: python -m pip install -e ".[dev,network,dataframe]"
+      - run: ruff check .
+      - run: python -m pytest
+      - run: python -m build
+      - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: distributions-${{ matrix.os }}-${{ matrix.python }}
+          path: dist/*

pybynix-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,33 @@
+name: publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pybynix
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.13"
+      - name: Build distributions
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

pybynix-1.0.0/.gitignore

@@ -0,0 +1,22 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+dist/
+*.egg-info/
+.env
+.env.*
+!.env.example
+session*.json
+*.har
+browser-profile/
+*.sqlite
+*.sqlite3
+*.sqlite-wal
+*.sqlite-shm
+*.db
+*.db-wal
+*.db-shm
+.pybynix-session-*
+private/

pybynix-1.0.0/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+## 1.0.0 - release-preparation snapshot, 22 October 2026
+
+- Independent REST + Socket.IO client based on observed Bynix behavior.
+- Explicit session, password, browser and custom providers; challenge-only fallback.
+- Typed market ticks/candles, history, account events and bounded stream subscriptions.
+- Demo-default execution, settlement lookup, early close and uncertain-order reporting.
+- HTTP CONNECT proxy, static DNS overrides and trusted login-host chain.
+- Twenty maintained README editions, localized quickstarts, diagnostics CLI, replay tests and
+  documented measurements.
+- Profile health refresh is isolated from market fallback with bounded, zero-retry
+  supervision polling; regression coverage includes a deliberately slow profile response.
+- All public SDK capabilities are included in the MIT package without a paid or premium
+  feature tier. Added pure Decimal SMA/EMA/RSI/MACD/Bollinger/ATR/stochastic helpers,
+  `buy_and_wait`, the explicit `sell` early-close alias, and caller-owned automation.
+- Added fail-closed orchestration: unknown order outcomes, journal failures, missing trade IDs,
+  and settlement errors pause new submissions; idle sources stop cleanly and in-flight order
+  submissions are drained rather than blindly canceled.
+- Added bounded-concurrency independent candle batching and opt-in historical-page caching;
+  latest/forming queries are never cached.
+- Completed source-fingerprinted three-stream demo soak: 600.801864 seconds, one scheduled
+  reconnect, 3,597 ticks, zero malformed/duplicate ticks, on the owner's Windows demo setup.
+- Selected green/gold concept 07 branding. The GitHub repository is now public; PyPI publication
+  remains a separate release action. No premium parity or production certification is claimed.

pybynix-1.0.0/CITATION.cff

@@ -0,0 +1,9 @@
+cff-version: 1.2.0
+message: "If you use this software, cite the version and its repository when published."
+type: software
+title: PyBynix
+version: 1.0.0
+authors:
+  - family-names: Hossain Bappy
+    given-names: C. M. Jubayer
+license: MIT

pybynix-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contributing
+
+Install `.[dev,network,dataframe]`, then run `ruff check .`, `pytest` and `python -m build`.
+Use synthetic fixtures or fully sanitized observed samples. Ordinary tests must not
+log into an account, send an order or require network access. Record live demo checks
+separately with date, code version and limitations. Keep strategies out of the SDK.
+
+New endpoints need observed requests/responses, typed failure behavior and meaningful
+tests. Never infer platform capability from a method name in a different broker SDK.
+
+The twenty README editions use reviewed UTF-8 sources in docs/i18n/locales/. Change
+the appropriate locale and run `python tools/readmes.py`; don't hand-edit generated
+README files. Preserve method names and code samples across languages. Ordinary tests
+check local links, feature completeness and Python snippet syntax without network access.
+
+Live validation is deliberately separate: tools/live_lab.py only affects its own local
+test relays; tools/soak.py performs a finite read-only stream run. Demo order experiments
+are explicitly scoped and must keep account/trade identifiers out of public artifacts.
+
+Run release packaging from a reviewed, committed public checkout with
+`python tools/package_release.py --out PATH`. Publish only its public artifacts; owner
+sessions, browser profiles, order databases and manuscript working files stay separate.

pybynix-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 C. M. Jubayer Hossain Bappy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pybynix-1.0.0/NOTICE.md

@@ -0,0 +1,9 @@
+# Attribution and marks
+
+PyBynix is independently implemented. PyQuotex and the owner's QX-PY-API were reviewed as
+interface and workflow references; their source files were not copied into this package.
+
+The selected green/gold logo was AI-assisted from the owner's chosen concept, combining
+the supplied Bynix mark with Python-inspired forms. Bynix and Python marks belong to
+their respective rights holders. The code's MIT license grants no trademark rights or
+claim of endorsement. Review branding permissions before a public production release.

pybynix-1.0.0/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.5
+Name: pybynix
+Version: 1.0.0
+Summary: Unofficial asynchronous Bynix market data and execution client
+Project-URL: Homepage, https://github.com/thecmjhb/PyBynix
+Project-URL: Repository, https://github.com/thecmjhb/PyBynix
+Project-URL: Issues, https://github.com/thecmjhb/PyBynix/issues
+Author: C. M. Jubayer Hossain Bappy
+License-Expression: MIT
+License-File: LICENSE
+License-File: NOTICE.md
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: aiohttp<4,>=3.12
+Requires-Dist: httpcore<2,>=1
+Requires-Dist: httpx<1,>=0.28
+Requires-Dist: python-socketio[asyncio-client]<6,>=5.13
+Provides-Extra: browser
+Requires-Dist: playwright<2,>=1.49; extra == 'browser'
+Provides-Extra: dataframe
+Requires-Dist: pandas<4,>=2.2; extra == 'dataframe'
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: pytest-asyncio<2,>=0.24; extra == 'dev'
+Requires-Dist: pytest<10,>=8; extra == 'dev'
+Requires-Dist: ruff>=0.9; extra == 'dev'
+Provides-Extra: network
+Requires-Dist: aiohttp-socks<1,>=0.10; extra == 'network'
+Requires-Dist: dnspython<3,>=2.6; extra == 'network'
+Requires-Dist: httpx[socks]<1,>=0.28; extra == 'network'
+Description-Content-Type: text/markdown
+
+<!-- Generated by tools/readmes.py; edit docs/i18n/locales/en.json. -->
+<div align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark.png">
+    <source media="(prefers-color-scheme: light)" srcset="assets/logo.png">
+    <img src="assets/logo.png" alt="PyBynix" width="390">
+  </picture>
+  <h3>Market data. Trade execution. One Python client.</h3>
+  <p>An asynchronous Python interface for Bynix, built for trading applications, data pipelines and developer tools.</p>
+  <p>
+    <img src="https://img.shields.io/badge/Python-3.11%2B-3776AB?logo=python&amp;logoColor=white" alt="Python 3.11+">
+    <img src="https://img.shields.io/badge/Version-1.0.0-00843D" alt="Version 1.0.0">
+    <img src="https://img.shields.io/badge/License-MIT-22c55e" alt="MIT">
+    <img src="https://img.shields.io/badge/Documentation-20_languages-C49A00" alt="20 languages">
+  </p>
+</div>
+
+<p align="center" dir="ltr"><a href="README.md" title="English"><img src="assets/languages/en.svg" width="58" height="28" alt="English"></a><a href="README.bn.md" title="বাংলা"><img src="assets/languages/bn.svg" width="58" height="28" alt="বাংলা"></a><a href="docs/i18n/README.zh-CN.md" title="中文"><img src="assets/languages/zh-CN.svg" width="58" height="28" alt="中文"></a><a href="docs/i18n/README.hi.md" title="हिन्दी"><img src="assets/languages/hi.svg" width="58" height="28" alt="हिन्दी"></a><a href="docs/i18n/README.es.md" title="Español"><img src="assets/languages/es.svg" width="58" height="28" alt="Español"></a><a href="docs/i18n/README.ar.md" title="العربية"><img src="assets/languages/ar.svg" width="58" height="28" alt="العربية"></a><a href="docs/i18n/README.fr.md" title="Français"><img src="assets/languages/fr.svg" width="58" height="28" alt="Français"></a><a href="docs/i18n/README.pt.md" title="Português"><img src="assets/languages/pt.svg" width="58" height="28" alt="Português"></a><a href="docs/i18n/README.id.md" title="Bahasa Indonesia"><img src="assets/languages/id.svg" width="58" height="28" alt="Bahasa Indonesia"></a><a href="docs/i18n/README.ur.md" title="اردو"><img src="assets/languages/ur.svg" width="58" height="28" alt="اردو"></a><a href="docs/i18n/README.ru.md" title="Русский"><img src="assets/languages/ru.svg" width="58" height="28" alt="Русский"></a><a href="docs/i18n/README.ko.md" title="한국어"><img src="assets/languages/ko.svg" width="58" height="28" alt="한국어"></a><a href="docs/i18n/README.ja.md" title="日本語"><img src="assets/languages/ja.svg" width="58" height="28" alt="日本語"></a><a href="docs/i18n/README.de.md" title="Deutsch"><img src="assets/languages/de.svg" width="58" height="28" alt="Deutsch"></a><a href="docs/i18n/README.tr.md" title="Türkçe"><img src="assets/languages/tr.svg" width="58" height="28" alt="Türkçe"></a><a href="docs/i18n/README.it.md" title="Italiano"><img src="assets/languages/it.svg" width="58" height="28" alt="Italiano"></a><a href="docs/i18n/README.fa.md" title="فارسی"><img src="assets/languages/fa.svg" width="58" height="28" alt="فارسی"></a><a href="docs/i18n/README.vi.md" title="Tiếng Việt"><img src="assets/languages/vi.svg" width="58" height="28" alt="Tiếng Việt"></a><a href="docs/i18n/README.ta.md" title="தமிழ்"><img src="assets/languages/ta.svg" width="58" height="28" alt="தமிழ்"></a><a href="docs/i18n/README.te.md" title="తెలుగు"><img src="assets/languages/te.svg" width="58" height="28" alt="తెలుగు"></a></p>
+
+## 🚀 Capability categories
+
+- 🛡️ **Free/open core** — MIT-licensed public package; public market data works without an account, with optional browser, network, and DataFrame extras.
+- ⚡ **Fast market data** — Stream-first ticks, forming/closed candles, bounded historical pages, and concurrent candle batches with REST fallback.
+- 🔑 **Multi-login and client pool** — Token, password, browser, and OTP-capable providers plus independent named clients and account events.
+- 🤖 **Safe caller-owned automation** — ExecutionOrchestrator/AutoExecutor accepts explicit application intents with dry-run, demo-only defaults, cooldown, concurrency limits, and no uncertain-order retry.
+- 📊 **Pure indicators** — Decimal SMA, EMA, RSI, MACD, Bollinger Bands, ATR, and stochastic measurements over caller-owned data; no signals or strategy.
+- 🎯 **Execution conveniences** — `buy_and_wait`, `sell`/early close, settlement wait, journaling, and reconciliation around explicit one-order-at-a-time calls.
+- 🔍 **Verified Bynix scope** — Read the matrix for implemented, offline-tested, and live-demo-observed behavior; unsupported parity is not implied.
+
+See the full verified scope in the [feature and fallback matrix](docs/FEATURE_MATRIX.md).
+
+## 🛠️ Features
+
+| API | Features |
+| --- | --- |
+| `connect · PasswordAuth · BrowserAuth` | Session tokens, password login, browser-assisted login and 2FA callbacks. |
+| `get_assets · get_asset · get_payouts` | Asset discovery, exact symbol lookup, availability and payout information. |
+| `get_candles · get_historical_candles · get_candles_batch` | Recent candles and paginated historical OHLCV with UTC timestamps. |
+| `subscribe_ticks · stream_candles · get_tick` | Live ticks, forming/closed candles and automatic REST polling fallback. |
+| `place_order · wait_order_result · close_trade_early · ExecutionOrchestrator` | Explicit demo, real and funded orders, settlement lookup and early close. |
+| `SQLiteJournal · reconcile_order · unresolved_orders` | Durable order records, restart recovery and duplicate-reference protection. |
+| `ClientPool · account_events · get_balance_breakdown` | Independent named clients, account events and detailed balances. |
+| `proxy · dns_servers · connect_any` | HTTP/SOCKS5 proxies, custom DNS and trusted-domain connection fallback. |
+| `get_realtime_sentiment · stream_sentiment` | Streaming market sentiment using the platform-style candle and tick model. |
+| `export_candles · candles_to_dataframe · resample_candles · sma · ema · rsi · macd · bollinger_bands · atr · stochastic` | Decimal-preserving CSV/JSON export, optional pandas and candle resampling. |
+
+## 📦 Installation
+
+Install the published package from PyPI. Add optional browser, networking and DataFrame integrations as needed.
+
+```console
+python -m pip install pybynix
+```
+
+```console
+python -m pip install "pybynix[browser,network,dataframe]"
+python -m playwright install chromium
+```
+
+## ⚡ Stream your first market
+
+Public market data works without an account. This complete example retrieves candles and reads three incoming ticks.
+
+```python
+import asyncio
+from pybynix import Bynix
+
+async def main():
+    async with Bynix.public() as client:
+        candles = await client.get_candles("EUR/USD OTC", interval="1m", count=100)
+        print(candles[-1])
+        async with await client.subscribe_ticks("EUR/USD OTC") as ticks:
+            for _ in range(3):
+                tick = await anext(ticks)
+                print(tick.timestamp, tick.price)
+
+asyncio.run(main())
+```
+
+## 🔐 Authentication and sessions
+
+Use the interactive login command, import an existing Bynix access token, or configure a password/browser provider. Login stores a local session; Python applications can also supply their own session provider. Use the client in an async context manager.
+
+```console
+pybynix login
+pybynix doctor
+pybynix balances
+```
+
+```python
+import asyncio
+import os
+from pybynix import Bynix, PasswordAuth, SQLiteJournal
+
+async def main():
+    async with Bynix(
+        provider=PasswordAuth(os.environ["BYNIX_EMAIL"], os.environ["BYNIX_PASSWORD"]),
+        journal=SQLiteJournal("orders.sqlite"),
+    ) as client:
+        print(await client.get_balance())
+
+asyncio.run(main())
+```
+
+## 🎯 Order execution
+
+With a connected authenticated client, place an explicit demo order and await the server result. Demo is the default account. Real or funded execution requires allow_real_trading=True; funded orders also require challenge_id. Keep order IDs and use SQLiteJournal for restart recovery.
+
+```python
+async def execute_demo_order(client):
+    order = await client.place_order("EUR/USD OTC", "call", "1.00", 5)
+    result = await client.wait_order_result(order["trade_id"], timeout=90)
+    return result
+```
+
+## 🌐 Connections and recovery
+
+Persistent connections, resubscription and bounded queues support continuous consumers. Auto mode uses the platform's REST tick endpoint when streaming is unavailable. Network extras enable authenticated SOCKS5 and custom DNS. Configure the same route on your authentication provider.
+
+```python
+client = Bynix.from_token(token, proxy="socks5://user:password@proxy-host:1080")
+# HTTP CONNECT: proxy="http://proxy-host:8080"
+# Custom DNS: Bynix.from_token(token, dns_servers=["1.1.1.1"])
+# Data fallback: Bynix.public(stream_transport="auto")
+```
+
+## 💻 Command-line tools
+
+Inspect the platform, stream prices, export candles and check published domains from the terminal. The CLI supplies public data directly and uses a saved session for account commands.
+
+```console
+pybynix stream --symbol "EUR/USD OTC" --interval 15s --count 5
+pybynix candles --symbol "EUR/USD OTC" --count 100 --output candles.csv
+pybynix sentiment --symbol "EUR/USD OTC"
+pybynix domains
+```
+
+## 📚 Documentation
+
+Detailed signatures, return values, runnable examples and recovery behavior are documented below. Use exact trade_symbol values from the asset catalog.
+
+- [API reference](docs/API.md)
+- [Authentication](docs/AUTHENTICATION.md)
+- [Examples](examples)
+- [Recovery and networking](docs/RECOVERY.md)
+- [Automation boundary](docs/AUTOMATION.md)
+- [Feature and fallback matrix](docs/FEATURE_MATRIX.md)
+- [Launch checklist](docs/LAUNCH_CHECKLIST.md)
+- [Repository map](docs/REPOSITORY_MAP.md)
+- [Troubleshooting](docs/TROUBLESHOOTING.md)
+
+## 🧪 Testing and performance
+
+The validation record lists tested Python versions, asset/timeframe coverage, demo execution, interrupted connections and measured performance. Reproducible tests and benchmark inputs accompany the source. [Validation](docs/VALIDATION.md) · [Benchmarks](benchmarks)
+
+## 🔬 Research
+
+The architecture, protocol adaptation, and empirical evaluation of PyBynix are documented in our research paper. It covers asynchronous stream recovery, safe order lifecycle handling, and benchmark observations.
+
+## 🤝 Community and license
+
+Contributions, reproducible bug reports and documentation improvements are welcome. PyBynix is independently maintained; platform and language trademarks remain with their owners. [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [MIT](LICENSE)
+
+<p align="center"><strong>C. M. Jubayer Hossain Bappy</strong> · PyBynix</p>

pybynix-1.0.0/README.bn.md

@@ -0,0 +1,164 @@
+<!-- Generated by tools/readmes.py; edit docs/i18n/locales/bn.json. -->
+<div align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark.png">
+    <source media="(prefers-color-scheme: light)" srcset="assets/logo.png">
+    <img src="assets/logo.png" alt="PyBynix" width="390">
+  </picture>
+  <h3>মার্কেট ডেটা ও ট্রেড এক্সিকিউশন—একটি Python ক্লায়েন্টে।</h3>
+  <p>Bynix-এর জন্য asynchronous Python interface; trading application, data pipeline ও developer tool তৈরির জন্য।</p>
+  <p>
+    <img src="https://img.shields.io/badge/Python-3.11%2B-3776AB?logo=python&amp;logoColor=white" alt="Python 3.11+">
+    <img src="https://img.shields.io/badge/Version-1.0.0-00843D" alt="Version 1.0.0">
+    <img src="https://img.shields.io/badge/License-MIT-22c55e" alt="MIT">
+    <img src="https://img.shields.io/badge/Documentation-20_languages-C49A00" alt="20 languages">
+  </p>
+</div>
+
+<p align="center" dir="ltr"><a href="README.md" title="English"><img src="assets/languages/en.svg" width="58" height="28" alt="English"></a><a href="README.bn.md" title="বাংলা"><img src="assets/languages/bn.svg" width="58" height="28" alt="বাংলা"></a><a href="docs/i18n/README.zh-CN.md" title="中文"><img src="assets/languages/zh-CN.svg" width="58" height="28" alt="中文"></a><a href="docs/i18n/README.hi.md" title="हिन्दी"><img src="assets/languages/hi.svg" width="58" height="28" alt="हिन्दी"></a><a href="docs/i18n/README.es.md" title="Español"><img src="assets/languages/es.svg" width="58" height="28" alt="Español"></a><a href="docs/i18n/README.ar.md" title="العربية"><img src="assets/languages/ar.svg" width="58" height="28" alt="العربية"></a><a href="docs/i18n/README.fr.md" title="Français"><img src="assets/languages/fr.svg" width="58" height="28" alt="Français"></a><a href="docs/i18n/README.pt.md" title="Português"><img src="assets/languages/pt.svg" width="58" height="28" alt="Português"></a><a href="docs/i18n/README.id.md" title="Bahasa Indonesia"><img src="assets/languages/id.svg" width="58" height="28" alt="Bahasa Indonesia"></a><a href="docs/i18n/README.ur.md" title="اردو"><img src="assets/languages/ur.svg" width="58" height="28" alt="اردو"></a><a href="docs/i18n/README.ru.md" title="Русский"><img src="assets/languages/ru.svg" width="58" height="28" alt="Русский"></a><a href="docs/i18n/README.ko.md" title="한국어"><img src="assets/languages/ko.svg" width="58" height="28" alt="한국어"></a><a href="docs/i18n/README.ja.md" title="日本語"><img src="assets/languages/ja.svg" width="58" height="28" alt="日本語"></a><a href="docs/i18n/README.de.md" title="Deutsch"><img src="assets/languages/de.svg" width="58" height="28" alt="Deutsch"></a><a href="docs/i18n/README.tr.md" title="Türkçe"><img src="assets/languages/tr.svg" width="58" height="28" alt="Türkçe"></a><a href="docs/i18n/README.it.md" title="Italiano"><img src="assets/languages/it.svg" width="58" height="28" alt="Italiano"></a><a href="docs/i18n/README.fa.md" title="فارسی"><img src="assets/languages/fa.svg" width="58" height="28" alt="فارسی"></a><a href="docs/i18n/README.vi.md" title="Tiếng Việt"><img src="assets/languages/vi.svg" width="58" height="28" alt="Tiếng Việt"></a><a href="docs/i18n/README.ta.md" title="தமிழ்"><img src="assets/languages/ta.svg" width="58" height="28" alt="தமிழ்"></a><a href="docs/i18n/README.te.md" title="తెలుగు"><img src="assets/languages/te.svg" width="58" height="28" alt="తెలుగు"></a></p>
+
+## 🚀 সক্ষমতার বিভাগ
+
+- 🛡️ **ফ্রি/ওপেন কোর** — MIT-লাইসেন্সযুক্ত public package; account ছাড়াই public market data, সঙ্গে optional browser, network ও DataFrame extras।
+- ⚡ **দ্রুত market data** — Stream-first tick, forming/closed candle, সীমাবদ্ধ historical page এবং REST fallback-সহ concurrent candle batch।
+- 🔑 **একাধিক login ও client pool** — Token, password, browser ও OTP-capable provider; independent named client এবং account event।
+- 🤖 **নিরাপদ caller-owned automation** — ExecutionOrchestrator/AutoExecutor শুধু application-এর explicit intent নেয়; dry-run, demo-only default, cooldown, concurrency limit এবং uncertain order retry নেই।
+- 📊 **Pure indicator** — Caller-owned data-র উপর Decimal SMA, EMA, RSI, MACD, Bollinger Bands, ATR ও stochastic measurement; signal বা strategy নয়।
+- 🎯 **Execution convenience** — `buy_and_wait`, `sell`/early close, settlement wait, journal ও reconciliation—explicit এক-order-at-a-time call-এর চারপাশে।
+- 🔍 **যাচাইকৃত Bynix scope** — Implemented, offline-tested ও live-demo-observed আচরণের জন্য matrix দেখুন; অযাচাইকৃত parity বোঝানো হয় না।
+
+যাচাইকৃত সম্পূর্ণ scope দেখুন [feature ও fallback matrix-এ](docs/FEATURE_MATRIX.md).
+
+## 🛠️ সুবিধাসমূহ
+
+| API | সুবিধাসমূহ |
+| --- | --- |
+| `connect · PasswordAuth · BrowserAuth` | Session token, password, browser login ও 2FA callback। |
+| `get_assets · get_asset · get_payouts` | Asset তালিকা, সঠিক symbol, availability ও payout তথ্য। |
+| `get_candles · get_historical_candles · get_candles_batch` | UTC timestamp-সহ সাম্প্রতিক ও paginated historical OHLCV candles। |
+| `subscribe_ticks · stream_candles · get_tick` | Live tick, চলমান ও closed candle; প্রয়োজন হলে REST polling fallback। |
+| `place_order · wait_order_result · close_trade_early · ExecutionOrchestrator` | Demo, real ও funded order, settlement result এবং early close। |
+| `SQLiteJournal · reconcile_order · unresolved_orders` | স্থায়ী order journal, restart recovery ও duplicate reference প্রতিরোধ। |
+| `ClientPool · account_events · get_balance_breakdown` | স্বাধীন named client, account event ও বিস্তারিত balance। |
+| `proxy · dns_servers · connect_any` | HTTP/SOCKS5 proxy, custom DNS ও trusted domain fallback। |
+| `get_realtime_sentiment · stream_sentiment` | Platform-style candle ও tick model থেকে streaming market sentiment। |
+| `export_candles · candles_to_dataframe · resample_candles · sma · ema · rsi · macd · bollinger_bands · atr · stochastic` | Decimal অক্ষুণ্ণ রেখে CSV/JSON export, pandas ও candle resampling। |
+
+## 📦 ইনস্টলেশন
+
+PyPI থেকে published package install করো। প্রয়োজন হলে browser, network ও DataFrame integration যোগ করো।
+
+```console
+python -m pip install pybynix
+```
+
+```console
+python -m pip install "pybynix[browser,network,dataframe]"
+python -m playwright install chromium
+```
+
+## ⚡ প্রথম live market stream
+
+Account ছাড়াই public market data নেওয়া যায়। এই সম্পূর্ণ উদাহরণটি candles আনে এবং তিনটি live tick পড়ে।
+
+```python
+import asyncio
+from pybynix import Bynix
+
+async def main():
+    async with Bynix.public() as client:
+        candles = await client.get_candles("EUR/USD OTC", interval="1m", count=100)
+        print(candles[-1])
+        async with await client.subscribe_ticks("EUR/USD OTC") as ticks:
+            for _ in range(3):
+                tick = await anext(ticks)
+                print(tick.timestamp, tick.price)
+
+asyncio.run(main())
+```
+
+## 🔐 লগইন ও session
+
+Interactive login, নিজের Bynix access token অথবা password/browser provider ব্যবহার করো। Login একটি local session রাখে; Python application নিজস্ব session provider-ও দিতে পারে। Client-কে async context manager-এর মধ্যে ব্যবহার করো।
+
+```console
+pybynix login
+pybynix doctor
+pybynix balances
+```
+
+```python
+import asyncio
+import os
+from pybynix import Bynix, PasswordAuth, SQLiteJournal
+
+async def main():
+    async with Bynix(
+        provider=PasswordAuth(os.environ["BYNIX_EMAIL"], os.environ["BYNIX_PASSWORD"]),
+        journal=SQLiteJournal("orders.sqlite"),
+    ) as client:
+        print(await client.get_balance())
+
+asyncio.run(main())
+```
+
+## 🎯 ট্রেড এক্সিকিউশন
+
+Connected authenticated client দিয়ে নির্দিষ্ট demo order দাও এবং server result-এর জন্য অপেক্ষা করো। Default account demo। Real বা funded execution-এর জন্য allow_real_trading=True লাগে; funded order-এ challenge_id-ও লাগবে। Order ID সংরক্ষণ করো এবং restart recovery-র জন্য SQLiteJournal ব্যবহার করো।
+
+```python
+async def execute_demo_order(client):
+    order = await client.place_order("EUR/USD OTC", "call", "1.00", 5)
+    result = await client.wait_order_result(order["trade_id"], timeout=90)
+    return result
+```
+
+## 🌐 Connection ও recovery
+
+Persistent connection, resubscription ও bounded queue দিয়ে দীর্ঘসময় data নেওয়া যায়। Streaming না থাকলে auto mode platform-এর REST tick endpoint ব্যবহার করে। Network extras-এ authenticated SOCKS5 ও custom DNS আছে। Authentication provider-এও একই route configure করো।
+
+```python
+client = Bynix.from_token(token, proxy="socks5://user:password@proxy-host:1080")
+# HTTP CONNECT: proxy="http://proxy-host:8080"
+# Custom DNS: Bynix.from_token(token, dns_servers=["1.1.1.1"])
+# Data fallback: Bynix.public(stream_transport="auto")
+```
+
+## 💻 কমান্ড-লাইন টুল
+
+Terminal থেকে platform পরীক্ষা, price stream, candle export ও published domain check করা যায়। Public data সরাসরি পাওয়া যায়; account command saved session ব্যবহার করে।
+
+```console
+pybynix stream --symbol "EUR/USD OTC" --interval 15s --count 5
+pybynix candles --symbol "EUR/USD OTC" --count 100 --output candles.csv
+pybynix sentiment --symbol "EUR/USD OTC"
+pybynix domains
+```
+
+## 📚 ডকুমেন্টেশন
+
+Method signature, return value, runnable example ও recovery behavior নিচের documentation-এ আছে। Asset catalog-এর exact trade_symbol ব্যবহার করো।
+
+- [API reference](docs/API.md)
+- [Authentication](docs/AUTHENTICATION.md)
+- [Examples](examples)
+- [Recovery and networking](docs/RECOVERY.md)
+- [Automation boundary](docs/AUTOMATION.md)
+- [Feature and fallback matrix](docs/FEATURE_MATRIX.md)
+- [Launch checklist](docs/LAUNCH_CHECKLIST.md)
+- [Repository map](docs/REPOSITORY_MAP.md)
+- [Troubleshooting](docs/TROUBLESHOOTING.md)
+
+## 🧪 পরীক্ষা ও performance
+
+Validation record-এ পরীক্ষিত Python version, asset/timeframe coverage, demo execution, connection interruption ও performance measurement আছে। Reproducible tests ও benchmark input source-এর সঙ্গে দেওয়া হয়েছে। [Validation](docs/VALIDATION.md) · [Benchmarks](benchmarks)
+
+## 🔬 গবেষণা
+
+PyBynix-এর আর্কিটেকচার, প্রোটোকল অ্যাডাপ্টেশন ও এভালুয়েশন রিসার্চ পেপারে বিস্তারিত তুলে ধরা হয়েছে। এতে অ্যাসিঙ্ক্রোনাস স্ট্রিম রিকভারি, নিরাপদ অর্ডার হ্যান্ডলিং ও বেঞ্চমার্কের প্রমাণ অন্তর্ভুক্ত রয়েছে।
+
+## 🤝 কমিউনিটি ও লাইসেন্স
+
+Contribution, পুনরায় যাচাই করা যায় এমন bug report এবং documentation improvement স্বাগত। PyBynix স্বাধীনভাবে পরিচালিত; platform ও language-এর trademark সংশ্লিষ্ট মালিকদের। [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [MIT](LICENSE)
+
+<p align="center"><strong>C. M. Jubayer Hossain Bappy</strong> · PyBynix</p>