quant-agent 0.3.0__tar.gz → 0.3.1__tar.gz

{quant_agent-0.3.0 → quant_agent-0.3.1}/PKG-INFO

@@ -1,9 +1,12 @@
 Metadata-Version: 2.4
 Name: quant-agent
-Version: 0.3.0
+Version: 0.3.1
 Summary: Vietnam Quantitative Trading and Market Data Agent
-Author: quant-agent
+Author-email: Tom Tran <thangtran.com@gmail.com>
 License-Expression: MIT
+Project-URL: Homepage, https://github.com/tomtranai/quant-agent
+Project-URL: Repository, https://github.com/tomtranai/quant-agent
+Project-URL: Bug Tracker, https://github.com/tomtranai/quant-agent/issues
 Keywords: vietnam,stock,quant,trading,agent,finance,algorithmic-trading
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
@@ -18,6 +21,7 @@ Requires-Dist: python-dateutil>=2.8.0
 
 # quant-agent: Thư viện Phân tích Dữ liệu Chứng khoán & Giao dịch Việt Nam
 
+[![PyPI version](https://img.shields.io/pypi/v/quant-agent.svg)](https://pypi.org/project/quant-agent/)
 [![Python](https://img.shields.io/badge/Python-3.10%2B-blue.svg)](https://www.python.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 [![Market Data: Free](https://img.shields.io/badge/Market%20Data-Free%20%2F%20No%20Key-brightgreen.svg)]()
@@ -86,18 +90,27 @@ Hệ thống đã được tái cấu trúc và phân lập tầng nguồn dữ
 - Python >= 3.10
 - Kết nối Internet ổn định
 
-### Cài đặt thư viện
-Clone repository và cài đặt ở chế độ editable hoặc build trực tiếp:
+### 1. Cài đặt trực tiếp từ PyPI (Khuyến nghị)
+Bạn có thể cài đặt trực tiếp bản phát hành chính thức thông qua `pip`:
+
+```bash
+pip install quant-agent
+```
+
+Để nâng cấp lên phiên bản mới nhất bất kỳ lúc nào:
+```bash
+pip install -U quant-agent
+```
+
+### 2. Cài đặt từ mã nguồn (Dành cho nhà phát triển / Đóng góp mã nguồn)
+Clone repository và cài đặt ở chế độ editable:
 
 ```bash
 # Clone repository
-git clone https://github.com/quant-agent/quant-agent.git
+git clone https://github.com/tomtranai/quant-agent.git
 cd quant-agent
 
-# Cài đặt các gói phụ thuộc
-pip install -r requirements.txt
-
-# Hoặc cài đặt trực tiếp dạng package
+# Cài đặt các gói phụ thuộc & editable mode
 pip install -e .
 ```
 
@@ -184,6 +197,9 @@ graph TD
 
 ```python
 import quant_agent as qa
+
+# Kiểm tra phiên bản
+print(qa.__version__)  # 0.3.1
 ```
 
 ### 1. Danh sách mã niêm yết

{quant_agent-0.3.0 → quant_agent-0.3.1}/README.md

@@ -1,5 +1,6 @@
 # quant-agent: Thư viện Phân tích Dữ liệu Chứng khoán & Giao dịch Việt Nam
 
+[![PyPI version](https://img.shields.io/pypi/v/quant-agent.svg)](https://pypi.org/project/quant-agent/)
 [![Python](https://img.shields.io/badge/Python-3.10%2B-blue.svg)](https://www.python.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 [![Market Data: Free](https://img.shields.io/badge/Market%20Data-Free%20%2F%20No%20Key-brightgreen.svg)]()
@@ -68,18 +69,27 @@ Hệ thống đã được tái cấu trúc và phân lập tầng nguồn dữ
 - Python >= 3.10
 - Kết nối Internet ổn định
 
-### Cài đặt thư viện
-Clone repository và cài đặt ở chế độ editable hoặc build trực tiếp:
+### 1. Cài đặt trực tiếp từ PyPI (Khuyến nghị)
+Bạn có thể cài đặt trực tiếp bản phát hành chính thức thông qua `pip`:
+
+```bash
+pip install quant-agent
+```
+
+Để nâng cấp lên phiên bản mới nhất bất kỳ lúc nào:
+```bash
+pip install -U quant-agent
+```
+
+### 2. Cài đặt từ mã nguồn (Dành cho nhà phát triển / Đóng góp mã nguồn)
+Clone repository và cài đặt ở chế độ editable:
 
 ```bash
 # Clone repository
-git clone https://github.com/quant-agent/quant-agent.git
+git clone https://github.com/tomtranai/quant-agent.git
 cd quant-agent
 
-# Cài đặt các gói phụ thuộc
-pip install -r requirements.txt
-
-# Hoặc cài đặt trực tiếp dạng package
+# Cài đặt các gói phụ thuộc & editable mode
 pip install -e .
 ```
 
@@ -166,6 +176,9 @@ graph TD
 
 ```python
 import quant_agent as qa
+
+# Kiểm tra phiên bản
+print(qa.__version__)  # 0.3.1
 ```
 
 ### 1. Danh sách mã niêm yết

{quant_agent-0.3.0 → quant_agent-0.3.1}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "quant-agent"
-version = "0.3.0"
+version = "0.3.1"
 description = "Vietnam Quantitative Trading and Market Data Agent"
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
 authors = [
-    { name = "quant-agent" }
+    { name = "Tom Tran", email = "thangtran.com@gmail.com" }
 ]
 keywords = ["vietnam", "stock", "quant", "trading", "agent", "finance", "algorithmic-trading"]
 classifiers = [
@@ -26,6 +26,11 @@ dependencies = [
     "python-dateutil>=2.8.0",
 ]
 
+[project.urls]
+Homepage = "https://github.com/tomtranai/quant-agent"
+Repository = "https://github.com/tomtranai/quant-agent"
+"Bug Tracker" = "https://github.com/tomtranai/quant-agent/issues"
+
 [tool.setuptools.packages.find]
 where = ["."]
 include = ["quant_agent*"]

{quant_agent-0.3.0 → quant_agent-0.3.1}/quant_agent/__init__.py

@@ -12,7 +12,8 @@ this read-only library. It's re-exported here too for backward
 compatibility, but see `broker/__init__.py` before using it.
 """
 
-__author__ = "quant-agent"
+__version__ = "0.3.1"
+__author__ = "Tom Tran"
 
 from .config import *       # date helpers + re-exports the `sources` subpackage
 from .utils import *

{quant_agent-0.3.0 → quant_agent-0.3.1}/quant_agent/fundamental.py

@@ -263,7 +263,7 @@ def company_insider_deals (symbol='TCB', page_size=20, page=0, headers=None):
     payload = fetch_json('GET', url, headers=vci_headers, source='VCI')
     if payload is None:
         return None
-    content = payload.get('data', {}).get('content', [])
+    content = (payload.get('data') or {}).get('content', [])
     if not content:
         print(f'No insider dealing data returned by VCI for {symbol}.')
         return None
@@ -339,7 +339,7 @@ def company_events (symbol='TPB', page_size=15, page=0, headers=None):
     payload = fetch_json('GET', url, headers=vci_headers, source='VCI')
     if payload is None:
         return None
-    content = payload.get('data', {}).get('content', [])
+    content = (payload.get('data') or {}).get('content', [])
     if not content:
         print(f'No events returned by VCI for {symbol}.')
         return None
@@ -362,7 +362,7 @@ def company_news (symbol='TCB', page_size=15, page=0, headers=None):
     payload = fetch_json('GET', url, headers=vci_headers, source='VCI')
     if payload is None:
         return None
-    content = payload.get('data', {}).get('content', [])
+    content = (payload.get('data') or {}).get('content', [])
     if not content:
         print(f'No news returned by VCI for {symbol}.')
         return None
@@ -392,7 +392,7 @@ def _vci_financial_statement(symbol, report_type, frequency):
     payload = fetch_json('GET', url, headers=headers, params={'section': section}, source='VCI')
     if payload is None:
         return None
-    data = payload.get('data', {})
+    data = payload.get('data') or {}
     key = 'years' if frequency.lower().startswith('year') else 'quarters'
     records = data.get(key, [])
     if not records:
@@ -539,7 +539,7 @@ def dividend_history (symbol):
     payload = fetch_json('GET', url, headers=vci_headers, source='VCI')
     if payload is None:
         return None
-    content = payload.get('data', {}).get('content', [])
+    content = (payload.get('data') or {}).get('content', [])
     if not content:
         print(f'No dividend history returned by VCI for {symbol}.')
         return None

{quant_agent-0.3.0 → quant_agent-0.3.1}/quant_agent/technical.py

@@ -27,10 +27,7 @@ def stock_historical_data (symbol='TCB', start_date='2023-06-01', end_date='2023
     if source.upper() == 'DNSE':
         df = ohlc_data(symbol, start_date, end_date, resolution, type, headers=entrade_headers)
     elif source.upper() == 'VCI':
-        if resolution != '1D':
-            print("VCI only supports longterm daily data. Please set resolution to '1D'")
-            return None
-        df = longterm_ohlc_data(symbol, start_date, end_date, 'D', type)
+        df = longterm_ohlc_data(symbol, start_date, end_date, resolution, type)
     else:
         print(f"Unknown source '{source}'. Use 'DNSE' or 'VCI'.")
         return None
@@ -46,7 +43,13 @@ def stock_historical_data (symbol='TCB', start_date='2023-06-01', end_date='2023
     return df
 
 
-_VCI_TIMEFRAME_MAP = {'D': 'ONE_DAY', '1D': 'ONE_DAY', 'H': 'ONE_HOUR', '1H': 'ONE_HOUR', '1': 'ONE_MINUTE'}
+_VCI_TIMEFRAME_MAP = {
+    'D': 'ONE_DAY', '1D': 'ONE_DAY',
+    'H': 'ONE_HOUR', '1H': 'ONE_HOUR',
+    '1': 'ONE_MINUTE', '1M': 'ONE_MINUTE', '1m': 'ONE_MINUTE',
+    '15': 'FIFTEEN_MINUTES', '15m': 'FIFTEEN_MINUTES',
+    '30': 'THIRTY_MINUTES', '30m': 'THIRTY_MINUTES',
+}
 
 def longterm_ohlc_data (symbol='REE', start_date='2022-01-01', end_date='2023-10-31', resolution='D', type='stock', headers=None):
     """
@@ -63,8 +66,22 @@ def longterm_ohlc_data (symbol='REE', start_date='2022-01-01', end_date='2023-10
     timeframe = _VCI_TIMEFRAME_MAP.get(resolution, 'ONE_DAY')
     start_dt = datetime.strptime(start_date, '%Y-%m-%d')
     end_dt = datetime.strptime(end_date, '%Y-%m-%d')
-    count_back = (end_dt - start_dt).days + 5  # small buffer for non-trading days
-    to_timestamp = int(end_dt.timestamp())
+
+    days = max((end_dt - start_dt).days + 1, 1)
+    if timeframe == 'ONE_MINUTE':
+        count_back = min(max(days * 250, 300), 1000)
+    elif timeframe in ['FIFTEEN_MINUTES', 'THIRTY_MINUTES']:
+        count_back = min(max(days * 20, 100), 1000)
+    elif timeframe == 'ONE_HOUR':
+        count_back = min(max(days * 6, 50), 1000)
+    else:
+        count_back = min(days + 5, 1000)
+
+    today_str = datetime.now().strftime('%Y-%m-%d')
+    if end_date >= today_str:
+        to_timestamp = int(datetime.now().timestamp())
+    else:
+        to_timestamp = int((end_dt + timedelta(days=1)).timestamp())
 
     url = 'https://trading.vietcap.com.vn/api/chart/OHLCChart/gap-chart'
     payload = {'timeFrame': timeframe, 'symbols': [symbol], 'to': to_timestamp, 'countBack': count_back}
@@ -74,12 +91,22 @@ def longterm_ohlc_data (symbol='REE', start_date='2022-01-01', end_date='2023-10
         return None
 
     bars = data[0]
+    dt_series = pd.to_datetime([int(t) for t in bars['t']], unit='s').tz_localize('UTC').tz_convert('Asia/Ho_Chi_Minh')
+    if timeframe in ['ONE_MINUTE', 'FIFTEEN_MINUTES', 'THIRTY_MINUTES', 'ONE_HOUR']:
+        time_vals = dt_series.strftime('%Y-%m-%d %H:%M:%S')
+    else:
+        time_vals = dt_series.strftime('%Y-%m-%d')
+
     df = pd.DataFrame({
-        'time': pd.to_datetime([int(t) for t in bars['t']], unit='s').strftime('%Y-%m-%d'),
+        'time': time_vals,
         'open': bars['o'], 'high': bars['h'], 'low': bars['l'], 'close': bars['c'], 'volume': bars['v'],
     })
     df['ticker'] = symbol
-    df = df[(df['time'] >= start_date) & (df['time'] <= end_date)]
+
+    start_cmp = start_date if timeframe not in ['ONE_MINUTE', 'FIFTEEN_MINUTES', 'THIRTY_MINUTES', 'ONE_HOUR'] else f"{start_date} 00:00:00"
+    end_cmp = end_date if timeframe not in ['ONE_MINUTE', 'FIFTEEN_MINUTES', 'THIRTY_MINUTES', 'ONE_HOUR'] else f"{end_date} 23:59:59"
+    df = df[(df['time'] >= start_cmp) & (df['time'] <= end_cmp)]
+
     if type == 'stock':
         df[['open', 'high', 'low', 'close']] = round(df[['open', 'high', 'low', 'close']] / 1000, 2)
     df[['open', 'high', 'low', 'close']] = df[['open', 'high', 'low', 'close']].astype(float)

{quant_agent-0.3.0 → quant_agent-0.3.1}/quant_agent/trading.py

@@ -67,11 +67,14 @@ def price_board (symbol_ls):
     for item in data:
         row = {}
         listing = item.get('listingInfo', {}) or {}
-        row['ticker'] = listing.get('ticker')
+        row['ticker'] = listing.get('ticker') or listing.get('symbol') or item.get('symbol')
+        row['mappingSymbol'] = listing.get('mappingSymbol')
         row['exchange'] = listing.get('board')
         match = item.get('matchPrice', {}) or {}
         row['matchPrice'] = match.get('matchPrice')
         row['matchVolume'] = match.get('matchVol')
+        row['accumulatedVolume'] = match.get('accumulatedVolume')
+        row['openInterest'] = match.get('openInterest')
         bid_ask = item.get('bidAsk', {}) or {}
         for i, level in enumerate(bid_ask.get('bidPrices', [])[:3], start=1):
             row[f'bidPrice{i}'] = level.get('price')

{quant_agent-0.3.0 → quant_agent-0.3.1}/quant_agent.egg-info/PKG-INFO

@@ -1,9 +1,12 @@
 Metadata-Version: 2.4
 Name: quant-agent
-Version: 0.3.0
+Version: 0.3.1
 Summary: Vietnam Quantitative Trading and Market Data Agent
-Author: quant-agent
+Author-email: Tom Tran <thangtran.com@gmail.com>
 License-Expression: MIT
+Project-URL: Homepage, https://github.com/tomtranai/quant-agent
+Project-URL: Repository, https://github.com/tomtranai/quant-agent
+Project-URL: Bug Tracker, https://github.com/tomtranai/quant-agent/issues
 Keywords: vietnam,stock,quant,trading,agent,finance,algorithmic-trading
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
@@ -18,6 +21,7 @@ Requires-Dist: python-dateutil>=2.8.0
 
 # quant-agent: Thư viện Phân tích Dữ liệu Chứng khoán & Giao dịch Việt Nam
 
+[![PyPI version](https://img.shields.io/pypi/v/quant-agent.svg)](https://pypi.org/project/quant-agent/)
 [![Python](https://img.shields.io/badge/Python-3.10%2B-blue.svg)](https://www.python.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 [![Market Data: Free](https://img.shields.io/badge/Market%20Data-Free%20%2F%20No%20Key-brightgreen.svg)]()
@@ -86,18 +90,27 @@ Hệ thống đã được tái cấu trúc và phân lập tầng nguồn dữ
 - Python >= 3.10
 - Kết nối Internet ổn định
 
-### Cài đặt thư viện
-Clone repository và cài đặt ở chế độ editable hoặc build trực tiếp:
+### 1. Cài đặt trực tiếp từ PyPI (Khuyến nghị)
+Bạn có thể cài đặt trực tiếp bản phát hành chính thức thông qua `pip`:
+
+```bash
+pip install quant-agent
+```
+
+Để nâng cấp lên phiên bản mới nhất bất kỳ lúc nào:
+```bash
+pip install -U quant-agent
+```
+
+### 2. Cài đặt từ mã nguồn (Dành cho nhà phát triển / Đóng góp mã nguồn)
+Clone repository và cài đặt ở chế độ editable:
 
 ```bash
 # Clone repository
-git clone https://github.com/quant-agent/quant-agent.git
+git clone https://github.com/tomtranai/quant-agent.git
 cd quant-agent
 
-# Cài đặt các gói phụ thuộc
-pip install -r requirements.txt
-
-# Hoặc cài đặt trực tiếp dạng package
+# Cài đặt các gói phụ thuộc & editable mode
 pip install -e .
 ```
 
@@ -184,6 +197,9 @@ graph TD
 
 ```python
 import quant_agent as qa
+
+# Kiểm tra phiên bản
+print(qa.__version__)  # 0.3.1
 ```
 
 ### 1. Danh sách mã niêm yết