twap-engine 0.1.0__tar.gz

twap_engine-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Akin Urkmez
+
+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.

twap_engine-0.1.0/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: twap-engine
+Version: 0.1.0
+Summary: Borsa-agnostik, bağımsız bir TWAP (Time-Weighted Average Price) emir dağıtım motoru. ccxt destekli her borsada çalışır.
+Author: Akin Urkmez
+License: MIT
+Project-URL: Homepage, https://pypi.org/project/twap-engine/
+Keywords: twap,trading,crypto,ccxt,algo-trading,execution
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ccxt
+Dynamic: license-file
+
+# TWAP Engine (Standalone)
+
+Borsa-agnostik, bağımsız bir **Time-Weighted Average Price (TWAP)** emir
+dağıtım motoru. Herhangi bir [ccxt](https://github.com/ccxt/ccxt) destekli
+borsada (Binance, Bybit, Kraken, vb.) çalışır. Hiçbir belirli projeye ya da
+altyapıya bağımlı değildir.
+
+## Özellikler
+
+- Büyük bir emri N eşit parçaya bölüp zaman aralığına yayar
+- **Slippage-abort**: fiyat referans noktasından belirli bir yüzdeden fazla
+  kayarsa kalan dilimleri otomatik iptal eder
+- **Minimum notional koruması**: borsanın minimum emir tutarının altında
+  kalacak dilimleri, hiç başlamadan reddeder
+
+> Bu, **temel (ücretsiz) sürümdür** — mekanik TWAP dağıtımı ve temel
+> güvenlik kontrollerini içerir. Eklenebilir/özel risk zekası (RSI, order
+> book analizi, haber akışı gibi harici sinyallere göre otomatik karar veren
+> katman) ayrı bir gelişmiş sürümün konusudur.
+
+## Kurulum
+
+```bash
+pip install twap-engine
+```
+
+Kaynak koddan kurmak isterseniz:
+
+```bash
+git clone <bu-repo>
+cd twap_engine_standalone
+pip install -e .
+```
+
+## Hızlı Başlangıç
+
+```python
+import asyncio
+import ccxt.async_support as ccxt
+from twap_engine import TWAPEngine
+
+async def main():
+    exchange = ccxt.binance({
+        "apiKey": "...",
+        "secret": "...",
+        "enableRateLimit": True,
+    })
+    exchange.set_sandbox_mode(True)  # ÖNCE TESTNET'TE DENEYİN
+
+    engine = TWAPEngine(
+        exchange=exchange,
+        symbol="BTC/USDT",
+        side="buy",
+        total_amount=0.01,
+        slices=5,
+        interval_s=2.0,
+        max_slippage_pct=0.003,   # %0.3
+        min_notional_usd=10.0,
+        order_type="market",
+    )
+
+    result = await engine.run()
+    print(result.status, result.slices_sent, "/", result.slices_requested)
+
+    await exchange.close()
+
+asyncio.run(main())
+```
+
+Daha fazla örnek için `example.py` dosyasına bakın.
+
+## Sonuç Nesnesi (TWAPResult)
+
+| Alan | Açıklama |
+|---|---|
+| `status` | `COMPLETED`, `ABORTED_SLIPPAGE`, `REJECTED_MIN_NOTIONAL`, `PARTIAL_ERROR` |
+| `slices_sent` / `slices_requested` | Kaç dilim gönderildi / istendi |
+| `filled_amount` | Gönderilen toplam miktar (base asset) |
+| `aborted_reason` | İptal/red nedeni (varsa) |
+| `orders` | Borsadan dönen ham emir yanıtları |
+| `errors` | Dilim bazında yakalanan hatalar |
+
+## Testler
+
+Gerçek borsaya bağlanmayan, sahte (fake) exchange ile çalışan hafif testler:
+
+```bash
+python test_engine.py
+```
+
+## Sınırlamalar / Sorumluluk Reddi
+
+- Bu yazılım **"OLDUĞU GİBİ" (AS-IS)** sunulmaktadır, HİÇBİR GARANTİ VERİLMEZ.
+- Finansal kayıplardan yazar sorumlu değildir. Gerçek parayla kullanmadan
+  önce mutlaka testnet/sandbox ortamında test edin.
+- Bu motor emir GÖNDERMEYİ yönetir; risk yönetimi, pozisyon takibi, kasa
+  muhasebesi gibi konular KAPSAM DIŞIDIR — kendi sisteminize entegre ederken
+  bunları siz eklemelisiniz.
+- Yalnızca "spot" tarzı basit emirler için tasarlanmıştır; kaldıraçlı/vadeli
+  işlemler için ek risk kontrolleri (likidasyon, marj) GEREKLİDİR ve bu
+  pakette YOKTUR.
+- Ticari kullanım/satış öncesi kendi lisans metninizi (MIT, ticari lisans
+  vb.) ve yasal sorumluluk reddi maddelerinizi eklemeniz önerilir — bu
+  paket bir lisans dosyası içermez.

twap_engine-0.1.0/README.md

@@ -0,0 +1,104 @@
+# TWAP Engine (Standalone)
+
+Borsa-agnostik, bağımsız bir **Time-Weighted Average Price (TWAP)** emir
+dağıtım motoru. Herhangi bir [ccxt](https://github.com/ccxt/ccxt) destekli
+borsada (Binance, Bybit, Kraken, vb.) çalışır. Hiçbir belirli projeye ya da
+altyapıya bağımlı değildir.
+
+## Özellikler
+
+- Büyük bir emri N eşit parçaya bölüp zaman aralığına yayar
+- **Slippage-abort**: fiyat referans noktasından belirli bir yüzdeden fazla
+  kayarsa kalan dilimleri otomatik iptal eder
+- **Minimum notional koruması**: borsanın minimum emir tutarının altında
+  kalacak dilimleri, hiç başlamadan reddeder
+
+> Bu, **temel (ücretsiz) sürümdür** — mekanik TWAP dağıtımı ve temel
+> güvenlik kontrollerini içerir. Eklenebilir/özel risk zekası (RSI, order
+> book analizi, haber akışı gibi harici sinyallere göre otomatik karar veren
+> katman) ayrı bir gelişmiş sürümün konusudur.
+
+## Kurulum
+
+```bash
+pip install twap-engine
+```
+
+Kaynak koddan kurmak isterseniz:
+
+```bash
+git clone <bu-repo>
+cd twap_engine_standalone
+pip install -e .
+```
+
+## Hızlı Başlangıç
+
+```python
+import asyncio
+import ccxt.async_support as ccxt
+from twap_engine import TWAPEngine
+
+async def main():
+    exchange = ccxt.binance({
+        "apiKey": "...",
+        "secret": "...",
+        "enableRateLimit": True,
+    })
+    exchange.set_sandbox_mode(True)  # ÖNCE TESTNET'TE DENEYİN
+
+    engine = TWAPEngine(
+        exchange=exchange,
+        symbol="BTC/USDT",
+        side="buy",
+        total_amount=0.01,
+        slices=5,
+        interval_s=2.0,
+        max_slippage_pct=0.003,   # %0.3
+        min_notional_usd=10.0,
+        order_type="market",
+    )
+
+    result = await engine.run()
+    print(result.status, result.slices_sent, "/", result.slices_requested)
+
+    await exchange.close()
+
+asyncio.run(main())
+```
+
+Daha fazla örnek için `example.py` dosyasına bakın.
+
+## Sonuç Nesnesi (TWAPResult)
+
+| Alan | Açıklama |
+|---|---|
+| `status` | `COMPLETED`, `ABORTED_SLIPPAGE`, `REJECTED_MIN_NOTIONAL`, `PARTIAL_ERROR` |
+| `slices_sent` / `slices_requested` | Kaç dilim gönderildi / istendi |
+| `filled_amount` | Gönderilen toplam miktar (base asset) |
+| `aborted_reason` | İptal/red nedeni (varsa) |
+| `orders` | Borsadan dönen ham emir yanıtları |
+| `errors` | Dilim bazında yakalanan hatalar |
+
+## Testler
+
+Gerçek borsaya bağlanmayan, sahte (fake) exchange ile çalışan hafif testler:
+
+```bash
+python test_engine.py
+```
+
+## Sınırlamalar / Sorumluluk Reddi
+
+- Bu yazılım **"OLDUĞU GİBİ" (AS-IS)** sunulmaktadır, HİÇBİR GARANTİ VERİLMEZ.
+- Finansal kayıplardan yazar sorumlu değildir. Gerçek parayla kullanmadan
+  önce mutlaka testnet/sandbox ortamında test edin.
+- Bu motor emir GÖNDERMEYİ yönetir; risk yönetimi, pozisyon takibi, kasa
+  muhasebesi gibi konular KAPSAM DIŞIDIR — kendi sisteminize entegre ederken
+  bunları siz eklemelisiniz.
+- Yalnızca "spot" tarzı basit emirler için tasarlanmıştır; kaldıraçlı/vadeli
+  işlemler için ek risk kontrolleri (likidasyon, marj) GEREKLİDİR ve bu
+  pakette YOKTUR.
+- Ticari kullanım/satış öncesi kendi lisans metninizi (MIT, ticari lisans
+  vb.) ve yasal sorumluluk reddi maddelerinizi eklemeniz önerilir — bu
+  paket bir lisans dosyası içermez.

twap_engine-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "twap-engine"
+version = "0.1.0"
+description = "Borsa-agnostik, bağımsız bir TWAP (Time-Weighted Average Price) emir dağıtım motoru. ccxt destekli her borsada çalışır."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.8"
+authors = [
+    { name = "Akin Urkmez" }
+]
+keywords = ["twap", "trading", "crypto", "ccxt", "algo-trading", "execution"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Financial and Insurance Industry",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Financial :: Investment",
+]
+dependencies = [
+    "ccxt",
+]
+
+[project.urls]
+Homepage = "https://pypi.org/project/twap-engine/"
+
+[tool.setuptools.packages.find]
+where = ["src"]

twap_engine-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

twap_engine-0.1.0/src/twap_engine/__init__.py

@@ -0,0 +1,3 @@
+from .engine import TWAPEngine, TWAPResult, TWAPStatus
+
+__all__ = ["TWAPEngine", "TWAPResult", "TWAPStatus"]

twap_engine-0.1.0/src/twap_engine/engine.py

@@ -0,0 +1,196 @@
+"""
+TWAP Engine — Bağımsız, Borsa-Agnostik TWAP Emir Dağıtım Motoru
+================================================================
+
+ccxt destekli HERHANGİ bir borsada çalışan, tek başına kullanılabilen bir
+Time-Weighted Average Price (TWAP) emir dağıtım motoru. Belirli bir projeye
+bağımlı değildir — kendi exchange client'ınızı verirsiniz. Kullanım için
+README.md'ye bakın.
+
+Not: Bu, TEMEL sürümdür — sadece mekanik TWAP dilimleme, slippage-abort ve
+minimum notional koruması içerir. Özel/eklenebilir risk zekası (RSI, order
+book analizi, haber akışı gibi harici sinyallere göre karar veren mantık)
+ayrı, gelişmiş bir sürümün konusudur ve bu pakette YOKTUR.
+"""
+import asyncio
+import logging
+from dataclasses import dataclass, field
+from enum import Enum
+from typing import Any, Callable, Dict, List, Optional
+
+logger = logging.getLogger("twap_engine")
+
+
+class TWAPStatus(str, Enum):
+    COMPLETED = "COMPLETED"                    # Tüm dilimler başarıyla gönderildi
+    ABORTED_SLIPPAGE = "ABORTED_SLIPPAGE"       # Fiyat sapması limiti aştı
+    REJECTED_MIN_NOTIONAL = "REJECTED_MIN_NOTIONAL"  # Dilim başı tutar minimumun altında
+    PARTIAL_ERROR = "PARTIAL_ERROR"             # Bazı dilimler hata verdi ama devam edildi
+
+
+@dataclass
+class TWAPResult:
+    status: TWAPStatus
+    symbol: str
+    side: str
+    total_amount: float
+    slices_requested: int
+    slices_sent: int
+    reference_price: float
+    filled_amount: float = 0.0
+    aborted_reason: Optional[str] = None
+    orders: List[Dict[str, Any]] = field(default_factory=list)
+    errors: List[str] = field(default_factory=list)
+
+
+class TWAPEngine:
+    """
+    Borsa-agnostik TWAP emir dağıtım motoru.
+
+    Args:
+        exchange: ccxt.async_support uyumlu, zaten kimlik doğrulanmış bir
+            exchange instance'ı (örn. ccxt.async_support.binance({...})).
+            Bu motor exchange'i OLUŞTURMAZ, sadece kullanır.
+        symbol: İşlem çifti, örn. "BTC/USDT" (ccxt formatı).
+        side: "buy" ya da "sell".
+        total_amount: Toplam miktar (base asset cinsinden, örn. BTC adedi).
+        slices: Kaç parçaya bölüneceği (varsayılan 5).
+        interval_s: Dilimler arası bekleme süresi, saniye (varsayılan 2.0).
+        max_slippage_pct: Referans fiyattan bu yüzdeden fazla sapma olursa
+            kalan dilimler iptal edilir (varsayılan 0.003 = %0.3).
+        min_notional_usd: Tek bir dilimin USD değeri bunun altındaysa TWAP
+            hiç başlamadan reddedilir (varsayılan 10.0 — Binance benzeri
+            borsaların tipik minimumu; kendi borsanızın kuralıyla değiştirin).
+        order_type: "market" ya da "limit" (limit için anlık fiyat kullanılır).
+        quote_price_fn: Opsiyonel. Fiyat almak için özel bir async fonksiyon
+            (varsayılan: exchange.fetch_ticker(symbol)['last']). Farklı bir
+            fiyat kaynağı (örn. kendi order book analiziniz) kullanmak
+            isterseniz buraya verin. İmza: async () -> float
+    """
+
+    def __init__(
+        self,
+        exchange: Any,
+        symbol: str,
+        side: str,
+        total_amount: float,
+        slices: int = 5,
+        interval_s: float = 2.0,
+        max_slippage_pct: float = 0.003,
+        min_notional_usd: float = 10.0,
+        order_type: str = "market",
+        quote_price_fn: Optional[Callable[[], Any]] = None,
+    ):
+        if side not in ("buy", "sell"):
+            raise ValueError("side 'buy' ya da 'sell' olmalıdır")
+        if slices < 1:
+            raise ValueError("slices en az 1 olmalıdır")
+        if total_amount <= 0:
+            raise ValueError("total_amount pozitif olmalıdır")
+        if order_type not in ("market", "limit"):
+            raise ValueError("order_type 'market' ya da 'limit' olmalıdır")
+
+        self.exchange = exchange
+        self.symbol = symbol
+        self.side = side
+        self.total_amount = total_amount
+        self.slices = slices
+        self.interval_s = interval_s
+        self.max_slippage_pct = max_slippage_pct
+        self.min_notional_usd = min_notional_usd
+        self.order_type = order_type
+        self._quote_price_fn = quote_price_fn or self._default_quote_price
+
+    async def _default_quote_price(self) -> float:
+        ticker = await self.exchange.fetch_ticker(self.symbol)
+        return float(ticker["last"])
+
+    async def run(self) -> TWAPResult:
+        """TWAP'ı çalıştırır ve tamamlanınca sonucu döner.
+
+        Fire-and-forget istiyorsanız: asyncio.create_task(engine.run())
+        """
+        slice_amount = self.total_amount / self.slices
+
+        reference_price = await self._quote_price_fn()
+        if reference_price is None or reference_price <= 0:
+            return TWAPResult(
+                status=TWAPStatus.REJECTED_MIN_NOTIONAL,
+                symbol=self.symbol, side=self.side,
+                total_amount=self.total_amount, slices_requested=self.slices,
+                slices_sent=0, reference_price=reference_price or 0.0,
+                aborted_reason=f"Geçersiz referans fiyat: {reference_price}",
+            )
+
+        slice_notional = slice_amount * reference_price
+        if slice_notional < self.min_notional_usd:
+            msg = (
+                f"Dilim başı ${slice_notional:.2f}, minimum ${self.min_notional_usd:.2f}. "
+                f"Ya slices'i azaltın ya da total_amount'i artırın."
+            )
+            logger.warning(f"[TWAP] REDDEDİLDİ: {msg}")
+            return TWAPResult(
+                status=TWAPStatus.REJECTED_MIN_NOTIONAL,
+                symbol=self.symbol, side=self.side,
+                total_amount=self.total_amount, slices_requested=self.slices,
+                slices_sent=0, reference_price=reference_price,
+                aborted_reason=msg,
+            )
+
+        result = TWAPResult(
+            status=TWAPStatus.COMPLETED,
+            symbol=self.symbol, side=self.side,
+            total_amount=self.total_amount, slices_requested=self.slices,
+            slices_sent=0, reference_price=reference_price,
+        )
+
+        logger.info(
+            f"[TWAP] {self.side.upper()} {self.total_amount} {self.symbol} "
+            f"{self.slices} dilime bölündü. Referans fiyat: {reference_price}"
+        )
+
+        for i in range(self.slices):
+            try:
+                current_price = await self._quote_price_fn()
+            except Exception as e:
+                result.errors.append(f"Dilim {i+1} fiyat sorgusu hatası: {e}")
+                current_price = reference_price  # son bilinen fiyata güven
+
+            deviation = abs(current_price - reference_price) / reference_price
+            if deviation > self.max_slippage_pct:
+                result.status = TWAPStatus.ABORTED_SLIPPAGE
+                result.aborted_reason = (
+                    f"%{deviation*100:.3f} sapma, limit %{self.max_slippage_pct*100:.3f} "
+                    f"({i}/{self.slices} dilim gönderilmişti)"
+                )
+                logger.warning(f"[TWAP] İPTAL (slippage): {result.aborted_reason}")
+                break
+
+            try:
+                order_kwargs = dict(
+                    symbol=self.symbol,
+                    type=self.order_type,
+                    side=self.side,
+                    amount=slice_amount,
+                    params={},
+                )
+                if self.order_type == "limit":
+                    order_kwargs["price"] = current_price
+
+                order = await self.exchange.create_order(**order_kwargs)
+                result.orders.append(order)
+                result.filled_amount += slice_amount
+                result.slices_sent += 1
+                logger.info(
+                    f"[TWAP] Dilim {i+1}/{self.slices} gönderildi: "
+                    f"{slice_amount} @ ~{current_price}"
+                )
+            except Exception as e:
+                result.errors.append(f"Dilim {i+1} emir hatası: {e}")
+                result.status = TWAPStatus.PARTIAL_ERROR
+                logger.error(f"[TWAP] Dilim {i+1} başarısız: {e}")
+
+            if i < self.slices - 1:
+                await asyncio.sleep(self.interval_s)
+
+        return result

twap_engine-0.1.0/src/twap_engine.egg-info/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: twap-engine
+Version: 0.1.0
+Summary: Borsa-agnostik, bağımsız bir TWAP (Time-Weighted Average Price) emir dağıtım motoru. ccxt destekli her borsada çalışır.
+Author: Akin Urkmez
+License: MIT
+Project-URL: Homepage, https://pypi.org/project/twap-engine/
+Keywords: twap,trading,crypto,ccxt,algo-trading,execution
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ccxt
+Dynamic: license-file
+
+# TWAP Engine (Standalone)
+
+Borsa-agnostik, bağımsız bir **Time-Weighted Average Price (TWAP)** emir
+dağıtım motoru. Herhangi bir [ccxt](https://github.com/ccxt/ccxt) destekli
+borsada (Binance, Bybit, Kraken, vb.) çalışır. Hiçbir belirli projeye ya da
+altyapıya bağımlı değildir.
+
+## Özellikler
+
+- Büyük bir emri N eşit parçaya bölüp zaman aralığına yayar
+- **Slippage-abort**: fiyat referans noktasından belirli bir yüzdeden fazla
+  kayarsa kalan dilimleri otomatik iptal eder
+- **Minimum notional koruması**: borsanın minimum emir tutarının altında
+  kalacak dilimleri, hiç başlamadan reddeder
+
+> Bu, **temel (ücretsiz) sürümdür** — mekanik TWAP dağıtımı ve temel
+> güvenlik kontrollerini içerir. Eklenebilir/özel risk zekası (RSI, order
+> book analizi, haber akışı gibi harici sinyallere göre otomatik karar veren
+> katman) ayrı bir gelişmiş sürümün konusudur.
+
+## Kurulum
+
+```bash
+pip install twap-engine
+```
+
+Kaynak koddan kurmak isterseniz:
+
+```bash
+git clone <bu-repo>
+cd twap_engine_standalone
+pip install -e .
+```
+
+## Hızlı Başlangıç
+
+```python
+import asyncio
+import ccxt.async_support as ccxt
+from twap_engine import TWAPEngine
+
+async def main():
+    exchange = ccxt.binance({
+        "apiKey": "...",
+        "secret": "...",
+        "enableRateLimit": True,
+    })
+    exchange.set_sandbox_mode(True)  # ÖNCE TESTNET'TE DENEYİN
+
+    engine = TWAPEngine(
+        exchange=exchange,
+        symbol="BTC/USDT",
+        side="buy",
+        total_amount=0.01,
+        slices=5,
+        interval_s=2.0,
+        max_slippage_pct=0.003,   # %0.3
+        min_notional_usd=10.0,
+        order_type="market",
+    )
+
+    result = await engine.run()
+    print(result.status, result.slices_sent, "/", result.slices_requested)
+
+    await exchange.close()
+
+asyncio.run(main())
+```
+
+Daha fazla örnek için `example.py` dosyasına bakın.
+
+## Sonuç Nesnesi (TWAPResult)
+
+| Alan | Açıklama |
+|---|---|
+| `status` | `COMPLETED`, `ABORTED_SLIPPAGE`, `REJECTED_MIN_NOTIONAL`, `PARTIAL_ERROR` |
+| `slices_sent` / `slices_requested` | Kaç dilim gönderildi / istendi |
+| `filled_amount` | Gönderilen toplam miktar (base asset) |
+| `aborted_reason` | İptal/red nedeni (varsa) |
+| `orders` | Borsadan dönen ham emir yanıtları |
+| `errors` | Dilim bazında yakalanan hatalar |
+
+## Testler
+
+Gerçek borsaya bağlanmayan, sahte (fake) exchange ile çalışan hafif testler:
+
+```bash
+python test_engine.py
+```
+
+## Sınırlamalar / Sorumluluk Reddi
+
+- Bu yazılım **"OLDUĞU GİBİ" (AS-IS)** sunulmaktadır, HİÇBİR GARANTİ VERİLMEZ.
+- Finansal kayıplardan yazar sorumlu değildir. Gerçek parayla kullanmadan
+  önce mutlaka testnet/sandbox ortamında test edin.
+- Bu motor emir GÖNDERMEYİ yönetir; risk yönetimi, pozisyon takibi, kasa
+  muhasebesi gibi konular KAPSAM DIŞIDIR — kendi sisteminize entegre ederken
+  bunları siz eklemelisiniz.
+- Yalnızca "spot" tarzı basit emirler için tasarlanmıştır; kaldıraçlı/vadeli
+  işlemler için ek risk kontrolleri (likidasyon, marj) GEREKLİDİR ve bu
+  pakette YOKTUR.
+- Ticari kullanım/satış öncesi kendi lisans metninizi (MIT, ticari lisans
+  vb.) ve yasal sorumluluk reddi maddelerinizi eklemeniz önerilir — bu
+  paket bir lisans dosyası içermez.

twap_engine-0.1.0/src/twap_engine.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/twap_engine/__init__.py
+src/twap_engine/engine.py
+src/twap_engine.egg-info/PKG-INFO
+src/twap_engine.egg-info/SOURCES.txt
+src/twap_engine.egg-info/dependency_links.txt
+src/twap_engine.egg-info/requires.txt
+src/twap_engine.egg-info/top_level.txt

twap_engine-0.1.0/src/twap_engine.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

twap_engine-0.1.0/src/twap_engine.egg-info/requires.txt

@@ -0,0 +1 @@
+ccxt

twap_engine-0.1.0/src/twap_engine.egg-info/top_level.txt

@@ -0,0 +1 @@
+twap_engine