quantvn 0.2.0__tar.gz → 0.2.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {quantvn-0.2.0/quantvn.egg-info → quantvn-0.2.1}/PKG-INFO +8 -3
- {quantvn-0.2.0 → quantvn-0.2.1}/README.md +7 -2
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/metrics/_fills.py +40 -3
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/metrics/backtest.py +13 -25
- {quantvn-0.2.0 → quantvn-0.2.1/quantvn.egg-info}/PKG-INFO +8 -3
- {quantvn-0.2.0 → quantvn-0.2.1}/setup.py +1 -1
- {quantvn-0.2.0 → quantvn-0.2.1}/tests/test_backtests.py +27 -12
- {quantvn-0.2.0 → quantvn-0.2.1}/LICENSE +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/MANIFEST.in +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/__init__.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/__init__.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/data/__init__.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/data/derivatives.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/data/download.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/metrics/__init__.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/metrics/backtest.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/metrics/metrics.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/metrics/__init__.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/metrics/portfolio.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/metrics/single_asset.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/metrics/st.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/paper/__init__.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/paper/client.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/paper/portfolio.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/paper/single_asset.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/strategy/__init__.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/strategy/frames.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/strategy/harness.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/strategy/script.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/us/__init__.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/us/data/__init__.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/us/data/stocks.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/us/metrics/__init__.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/us/metrics/backtest.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/__init__.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/__init__.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/const.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/core.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/derivatives.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/macro.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/stocks.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/utils.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/metrics/__init__.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/metrics/metrics.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn.egg-info/SOURCES.txt +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn.egg-info/dependency_links.txt +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn.egg-info/requires.txt +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/quantvn.egg-info/top_level.txt +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/setup.cfg +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/tests/test_paper.py +0 -0
- {quantvn-0.2.0 → quantvn-0.2.1}/tests/test_strategy.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: quantvn
|
|
3
|
-
Version: 0.2.
|
|
3
|
+
Version: 0.2.1
|
|
4
4
|
Summary: QuantVN API Library for Financial Data Analysis
|
|
5
5
|
Author: quantvn
|
|
6
6
|
Classifier: Development Status :: 3 - Alpha
|
|
@@ -673,7 +673,7 @@ Vị thế ghi ở một nến được quyết định bằng giá đóng cửa
|
|
|
673
673
|
- Vị thế của nến `t` được khớp tại `Open` của nến `t+1`.
|
|
674
674
|
- Mỗi nến ghi nhận lãi lỗ của vị thế cũ từ giá đóng cửa trước đến giá khớp, rồi của vị thế mới từ giá khớp đến giá đóng cửa.
|
|
675
675
|
- Phí được tính tại nến khớp, trên giá khớp.
|
|
676
|
-
- Chi phí thị trường Việt Nam
|
|
676
|
+
- Chi phí thị trường Việt Nam được tính theo từng khoản, đúng như nút "Run test" trên website QuantVN. Phái sinh VN30, mỗi hợp đồng mỗi chiều: phí giao dịch HNX 2.700 đồng và thuế thu nhập cá nhân 0,1% trên (giá khớp × 100.000 × tỷ lệ ký quỹ ban đầu 17% ÷ 2); thêm phí quản lý vị thế VSDC 2.550 đồng mỗi hợp đồng mỗi ngày cho vị thế còn mở cuối ngày, tính cả ngày nghỉ. Khi chỉ số ở 1.850, một chiều tốn khoảng 0,18 điểm. Cổ phiếu: phí môi giới 0,1% mỗi chiều và thuế 0,1% trên giá trị bán; cổ phiếu mua ngày T bán được từ 13:00 ngày T+2. Phí môi giới phái sinh và chênh lệch giá mua bán không nằm trong các lớp backtest; `paper.simulate` (mục 5.4) có tính.
|
|
677
677
|
- Nếu dữ liệu không có cột `Open`, vị thế được khớp tại giá đóng cửa của nến kế tiếp và thư viện phát cảnh báo.
|
|
678
678
|
|
|
679
679
|
Các bản đến 0.1.25 tính lãi lỗ của vị thế ngay từ giá đóng cửa của chính nến ra quyết định, tức là một mức giá đã qua. Vì vậy **kết quả backtest của cùng một chiến lược sẽ khác so với bản cũ**, nhất là với chiến lược giao dịch nhiều. Con số mới là con số có thể đạt được khi chạy thật; các ví dụ đầu ra bên dưới được tạo từ bản cũ nên chỉ minh họa định dạng.
|
|
@@ -925,7 +925,7 @@ print(result)
|
|
|
925
925
|
print(paper.simulate(df, market="VN_DERIVATIVE", delay_bars=2)) # chậm thêm một nến, gần với chạy thật ở khung 1 phút
|
|
926
926
|
```
|
|
927
927
|
|
|
928
|
-
- Chi phí mặc định lấy theo dịch vụ: phái sinh 1,5 bp mỗi chiều; cổ phiếu 15 bp mỗi chiều, thêm 10 bp thuế khi bán và nửa bước giá cho chênh lệch mua bán.
|
|
928
|
+
- Chi phí mặc định lấy theo dịch vụ: phái sinh 1,5 bp mỗi chiều; cổ phiếu 15 bp mỗi chiều, thêm 10 bp thuế khi bán và nửa bước giá cho chênh lệch mua bán. Mức này gồm cả phí môi giới và chênh lệch giá mua bán nên cao hơn chi phí theo từng khoản của các lớp backtest (mục 4.0).
|
|
929
929
|
- `result.nav` là vốn theo từng nến (bắt đầu từ 1), `result.fills` là các lần khớp, `result.daily` là lợi nhuận theo ngày, `result.stats` gồm lợi nhuận, Sharpe, mức sụt giảm tối đa.
|
|
930
930
|
- `result.notes` ghi rõ những gì mô phỏng này **chưa** tính: quy định T+2 và biên độ giá với cổ phiếu, việc chuyển hợp đồng hằng tháng với phái sinh. Dịch vụ Track Record có áp dụng các quy định đó.
|
|
931
931
|
|
|
@@ -1014,6 +1014,11 @@ Dự án này được phát hành theo giấy phép **MIT License**. Xem file [
|
|
|
1014
1014
|
|
|
1015
1015
|
## Changelog
|
|
1016
1016
|
|
|
1017
|
+
### Version 0.2.1
|
|
1018
|
+
|
|
1019
|
+
- Chi phí của `Backtest_Derivates` và `Backtest_Stock` trùng với website QuantVN: phí HNX, thuế thu nhập cá nhân và phí quản lý vị thế VSDC cho phái sinh; phí 0,1% và thuế bán 0,1% cho cổ phiếu, bán được từ 13:00 ngày T+2 (mục 4.0). Cùng một chiến lược cho cùng một kết quả trong thư viện và khi bấm "Run test"
|
|
1020
|
+
- `paper.simulate` giữ mức phí của dịch vụ Track Record (1,5 bp mỗi chiều cho phái sinh)
|
|
1021
|
+
|
|
1017
1022
|
### Version 0.2.0
|
|
1018
1023
|
|
|
1019
1024
|
- Thêm `quantvn.strategy`: lấy nến theo đúng khung nền tảng dùng, chạy thử chiến lược như khi chạy thật (`replay`), phát hiện nhìn trước tương lai (`check`), kiểm tra file trước khi tải lên (`validate_script`)
|
|
@@ -639,7 +639,7 @@ Vị thế ghi ở một nến được quyết định bằng giá đóng cửa
|
|
|
639
639
|
- Vị thế của nến `t` được khớp tại `Open` của nến `t+1`.
|
|
640
640
|
- Mỗi nến ghi nhận lãi lỗ của vị thế cũ từ giá đóng cửa trước đến giá khớp, rồi của vị thế mới từ giá khớp đến giá đóng cửa.
|
|
641
641
|
- Phí được tính tại nến khớp, trên giá khớp.
|
|
642
|
-
- Chi phí thị trường Việt Nam
|
|
642
|
+
- Chi phí thị trường Việt Nam được tính theo từng khoản, đúng như nút "Run test" trên website QuantVN. Phái sinh VN30, mỗi hợp đồng mỗi chiều: phí giao dịch HNX 2.700 đồng và thuế thu nhập cá nhân 0,1% trên (giá khớp × 100.000 × tỷ lệ ký quỹ ban đầu 17% ÷ 2); thêm phí quản lý vị thế VSDC 2.550 đồng mỗi hợp đồng mỗi ngày cho vị thế còn mở cuối ngày, tính cả ngày nghỉ. Khi chỉ số ở 1.850, một chiều tốn khoảng 0,18 điểm. Cổ phiếu: phí môi giới 0,1% mỗi chiều và thuế 0,1% trên giá trị bán; cổ phiếu mua ngày T bán được từ 13:00 ngày T+2. Phí môi giới phái sinh và chênh lệch giá mua bán không nằm trong các lớp backtest; `paper.simulate` (mục 5.4) có tính.
|
|
643
643
|
- Nếu dữ liệu không có cột `Open`, vị thế được khớp tại giá đóng cửa của nến kế tiếp và thư viện phát cảnh báo.
|
|
644
644
|
|
|
645
645
|
Các bản đến 0.1.25 tính lãi lỗ của vị thế ngay từ giá đóng cửa của chính nến ra quyết định, tức là một mức giá đã qua. Vì vậy **kết quả backtest của cùng một chiến lược sẽ khác so với bản cũ**, nhất là với chiến lược giao dịch nhiều. Con số mới là con số có thể đạt được khi chạy thật; các ví dụ đầu ra bên dưới được tạo từ bản cũ nên chỉ minh họa định dạng.
|
|
@@ -891,7 +891,7 @@ print(result)
|
|
|
891
891
|
print(paper.simulate(df, market="VN_DERIVATIVE", delay_bars=2)) # chậm thêm một nến, gần với chạy thật ở khung 1 phút
|
|
892
892
|
```
|
|
893
893
|
|
|
894
|
-
- Chi phí mặc định lấy theo dịch vụ: phái sinh 1,5 bp mỗi chiều; cổ phiếu 15 bp mỗi chiều, thêm 10 bp thuế khi bán và nửa bước giá cho chênh lệch mua bán.
|
|
894
|
+
- Chi phí mặc định lấy theo dịch vụ: phái sinh 1,5 bp mỗi chiều; cổ phiếu 15 bp mỗi chiều, thêm 10 bp thuế khi bán và nửa bước giá cho chênh lệch mua bán. Mức này gồm cả phí môi giới và chênh lệch giá mua bán nên cao hơn chi phí theo từng khoản của các lớp backtest (mục 4.0).
|
|
895
895
|
- `result.nav` là vốn theo từng nến (bắt đầu từ 1), `result.fills` là các lần khớp, `result.daily` là lợi nhuận theo ngày, `result.stats` gồm lợi nhuận, Sharpe, mức sụt giảm tối đa.
|
|
896
896
|
- `result.notes` ghi rõ những gì mô phỏng này **chưa** tính: quy định T+2 và biên độ giá với cổ phiếu, việc chuyển hợp đồng hằng tháng với phái sinh. Dịch vụ Track Record có áp dụng các quy định đó.
|
|
897
897
|
|
|
@@ -980,6 +980,11 @@ Dự án này được phát hành theo giấy phép **MIT License**. Xem file [
|
|
|
980
980
|
|
|
981
981
|
## Changelog
|
|
982
982
|
|
|
983
|
+
### Version 0.2.1
|
|
984
|
+
|
|
985
|
+
- Chi phí của `Backtest_Derivates` và `Backtest_Stock` trùng với website QuantVN: phí HNX, thuế thu nhập cá nhân và phí quản lý vị thế VSDC cho phái sinh; phí 0,1% và thuế bán 0,1% cho cổ phiếu, bán được từ 13:00 ngày T+2 (mục 4.0). Cùng một chiến lược cho cùng một kết quả trong thư viện và khi bấm "Run test"
|
|
986
|
+
- `paper.simulate` giữ mức phí của dịch vụ Track Record (1,5 bp mỗi chiều cho phái sinh)
|
|
987
|
+
|
|
983
988
|
### Version 0.2.0
|
|
984
989
|
|
|
985
990
|
- Thêm `quantvn.strategy`: lấy nến theo đúng khung nền tảng dùng, chạy thử chiến lược như khi chạy thật (`replay`), phát hiện nhìn trước tương lai (`check`), kiểm tra file trước khi tải lên (`validate_script`)
|
|
@@ -18,9 +18,20 @@ import numpy as np
|
|
|
18
18
|
import pandas as pd
|
|
19
19
|
|
|
20
20
|
|
|
21
|
-
#
|
|
22
|
-
#
|
|
23
|
-
#
|
|
21
|
+
# --- Backtest classes: the itemised statutory costs, the same the QuantVN website charges in "Run test".
|
|
22
|
+
# Sources: HNX trading fee and VSDC position fee, Thong tu 101/2021/TT-BTC; derivative personal income tax,
|
|
23
|
+
# Thong tu 87/2026/TT-BTC Dieu 5; initial margin, VSDC appendix effective 2026-10-16.
|
|
24
|
+
VN_FUT_MULTIPLIER = 100_000 # VND per VN30 index point
|
|
25
|
+
HNX_FEE_VND = 2_700 # per contract per matched side
|
|
26
|
+
VSDC_POSITION_FEE_VND = 2_550 # per contract per day, on positions open at the end of the day
|
|
27
|
+
DERIVATIVE_PIT_RATE = 0.001 # 0.1 % of the transfer price
|
|
28
|
+
VN30_INITIAL_MARGIN = 0.17 # transfer price = price x multiplier x contracts x initial margin / 2
|
|
29
|
+
STOCK_FEE_RATE = 0.001 # broker fee assumption on buys and sells (brokers differ)
|
|
30
|
+
STOCK_SELL_TAX_RATE = 0.001 # personal income tax on the value of a sale
|
|
31
|
+
STOCK_AFTERNOON_SELL_MINUTE = 13 * 60 # shares bought on T can be sold from 13:00 on T+2
|
|
32
|
+
|
|
33
|
+
# --- quantvn.paper.simulate: the flat rates of the QuantVN Track Record service (paper.quantvn.com).
|
|
34
|
+
# VN30 futures, per side: the statutory items above are about 1.1 bp of the contract's value at an index of
|
|
24
35
|
# 1,850; the rest is an allowance for broker commission and half a price step of spread.
|
|
25
36
|
VN_FUTURES_FEE = 1.5e-4
|
|
26
37
|
# Vietnamese stocks: a typical retail commission per side, the 0.1% tax on every sale, and half of one
|
|
@@ -29,6 +40,32 @@ VN_STOCK_FEE = 15e-4
|
|
|
29
40
|
VN_STOCK_SELL_TAX = 10e-4
|
|
30
41
|
|
|
31
42
|
|
|
43
|
+
def sellable(days_held: int, minute_of_day: int, min_hold_days: int) -> bool:
|
|
44
|
+
"""A stock lot settles on T+2: sellable on later days, or on day min_hold_days - 1 from 13:00."""
|
|
45
|
+
return days_held >= min_hold_days or (days_held == min_hold_days - 1 and minute_of_day >= STOCK_AFTERNOON_SELL_MINUTE)
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
def derivative_costs(df: pd.DataFrame) -> None:
|
|
49
|
+
"""Add HNX fee, income tax and VSDC position fee (index points per contract) to a time-indexed futures
|
|
50
|
+
frame that has `held` and `fill_price`. Contracts are traded when the holding changes, at the fill price;
|
|
51
|
+
the position fee is on the holding at the end of each day, for every calendar day until the next
|
|
52
|
+
trading day in the frame (1 on the last day)."""
|
|
53
|
+
held = df["held"]
|
|
54
|
+
traded = held.diff().abs().fillna(held.abs())
|
|
55
|
+
df["transaction_fee"] = traded * HNX_FEE_VND / VN_FUT_MULTIPLIER
|
|
56
|
+
df["tax"] = (traded * df["fill_price"] * VN30_INITIAL_MARGIN / 2 * DERIVATIVE_PIT_RATE).fillna(0.0)
|
|
57
|
+
dates = pd.Series(df.index.date, index=df.index)
|
|
58
|
+
df["date"] = dates.to_numpy()
|
|
59
|
+
days = pd.Series(sorted(set(dates)))
|
|
60
|
+
gaps = (pd.to_datetime(days.shift(-1)) - pd.to_datetime(days)).dt.days.fillna(1)
|
|
61
|
+
held_days = dates.map(dict(zip(days, gaps)))
|
|
62
|
+
last_bar = dates != dates.shift(-1)
|
|
63
|
+
carried = held.shift().fillna(0.0)
|
|
64
|
+
df["overnight"] = (carried != 0) & (dates != dates.shift())
|
|
65
|
+
df["overnight_fee"] = (held.abs() * VSDC_POSITION_FEE_VND / VN_FUT_MULTIPLIER * held_days).where(last_bar, 0.0)
|
|
66
|
+
df["total_fee"] = df["transaction_fee"] + df["tax"] + df["overnight_fee"]
|
|
67
|
+
|
|
68
|
+
|
|
32
69
|
def vn_tick(price: float, exchange: str = "HOSE") -> float:
|
|
33
70
|
"""Price step of a Vietnamese stock, in thousands of VND like the candles. HOSE: 10 VND below 10,000,
|
|
34
71
|
50 VND below 50,000, 100 VND from 50,000. HNX and UPCoM: 100 VND."""
|
|
@@ -3,8 +3,8 @@ import matplotlib.pyplot as plt
|
|
|
3
3
|
import numpy as np
|
|
4
4
|
import pandas as pd
|
|
5
5
|
|
|
6
|
-
from quantvn.metrics._fills import (
|
|
7
|
-
held_after_next_open, next_bar_pnl,
|
|
6
|
+
from quantvn.metrics._fills import (STOCK_FEE_RATE, STOCK_SELL_TAX_RATE, derivative_costs, fill_price,
|
|
7
|
+
held_after_next_open, next_bar_pnl, sellable)
|
|
8
8
|
|
|
9
9
|
|
|
10
10
|
class Backtest_Derivates:
|
|
@@ -64,21 +64,10 @@ class Backtest_Derivates:
|
|
|
64
64
|
self.df["held"] = held_after_next_open(self.df["position"])
|
|
65
65
|
self.df["pnl_raw"] = next_bar_pnl(self.df["held"], self.df["fill_price"], self.df["Close"])
|
|
66
66
|
|
|
67
|
-
# Costs
|
|
68
|
-
#
|
|
69
|
-
#
|
|
70
|
-
|
|
71
|
-
traded = self.df["held"].diff().abs().fillna(self.df["held"].abs())
|
|
72
|
-
self.df["transaction_fee"] = traded * self.df["fill_price"] * VN_FUTURES_FEE
|
|
73
|
-
|
|
74
|
-
self.df["date"] = self.df.index.date
|
|
75
|
-
carried = self.df["held"].shift().fillna(0.0)
|
|
76
|
-
self.df["overnight"] = (carried != 0) & (self.df["date"] != self.df["date"].shift())
|
|
77
|
-
self.df["overnight_fee"] = 0.0 # holding a contract overnight has no fee of its own
|
|
78
|
-
|
|
79
|
-
self.df["total_fee"] = self.df["transaction_fee"].fillna(0) + self.df[
|
|
80
|
-
"overnight_fee"
|
|
81
|
-
].fillna(0)
|
|
67
|
+
# Costs in index points per contract, itemised as on the QuantVN website: HNX fee and personal
|
|
68
|
+
# income tax on every contract traded, at the fill price, and the VSDC position fee on what is
|
|
69
|
+
# held at the end of each day (see quantvn.metrics._fills).
|
|
70
|
+
derivative_costs(self.df)
|
|
82
71
|
self.df["pnl_after_fees"] = self.df["pnl_raw"] - self.df["total_fee"]
|
|
83
72
|
|
|
84
73
|
def PNL(self):
|
|
@@ -243,14 +232,12 @@ class Backtest_Stock:
|
|
|
243
232
|
# PnL: vị thế cũ từ giá đóng cửa trước đến giá khớp, vị thế mới từ giá khớp đến giá đóng cửa
|
|
244
233
|
self.df["pnl_raw"] = next_bar_pnl(self.df["effective_position"], self.df["fill_price"], self.df["Close"])
|
|
245
234
|
|
|
246
|
-
# Chi phí mỗi lần khớp, tính trên giá khớp: phí môi giới 0,
|
|
247
|
-
# và
|
|
235
|
+
# Chi phí mỗi lần khớp, tính trên giá khớp, như trên website QuantVN: phí môi giới 0,1% mỗi chiều
|
|
236
|
+
# và thuế 0,1% trên giá trị bán.
|
|
248
237
|
qty = self.df["trade_qty"].to_numpy(dtype=float)
|
|
249
238
|
fill = self.df["fill_price"].to_numpy(dtype=float)
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
+ np.clip(-qty, 0.0, None) * fill * VN_STOCK_SELL_TAX
|
|
253
|
-
+ np.abs(qty) * half_step)
|
|
239
|
+
self.df["transaction_fee"] = (np.abs(qty) * fill * STOCK_FEE_RATE
|
|
240
|
+
+ np.clip(-qty, 0.0, None) * fill * STOCK_SELL_TAX_RATE)
|
|
254
241
|
|
|
255
242
|
self.df["pnl_after_fees"] = self.df["pnl_raw"] - self.df["transaction_fee"]
|
|
256
243
|
|
|
@@ -277,6 +264,7 @@ class Backtest_Stock:
|
|
|
277
264
|
dates = pd.Index(index.date)
|
|
278
265
|
day_change = np.r_[True, dates[1:] != dates[:-1]]
|
|
279
266
|
day_id = np.cumsum(day_change) - 1 # 0-based day id
|
|
267
|
+
minutes = np.asarray(index.hour * 60 + index.minute)
|
|
280
268
|
|
|
281
269
|
effective_pos = np.zeros(n, dtype=float)
|
|
282
270
|
trade_qty = np.zeros(n, dtype=float)
|
|
@@ -319,8 +307,8 @@ class Backtest_Stock:
|
|
|
319
307
|
qty_rem, d_entry = lot
|
|
320
308
|
if qty_rem <= 1e-12:
|
|
321
309
|
continue
|
|
322
|
-
#
|
|
323
|
-
if (int(day_id[i]) - int(d_entry))
|
|
310
|
+
# Thanh toán T+2: bán được từ 13:00 của ngày T+2, hoặc bất kỳ lúc nào sau đó
|
|
311
|
+
if sellable(int(day_id[i]) - int(d_entry), int(minutes[i]), min_hold_days):
|
|
324
312
|
sell_amt = min(qty_rem, to_sell)
|
|
325
313
|
lot[0] = qty_rem - sell_amt
|
|
326
314
|
to_sell -= sell_amt
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: quantvn
|
|
3
|
-
Version: 0.2.
|
|
3
|
+
Version: 0.2.1
|
|
4
4
|
Summary: QuantVN API Library for Financial Data Analysis
|
|
5
5
|
Author: quantvn
|
|
6
6
|
Classifier: Development Status :: 3 - Alpha
|
|
@@ -673,7 +673,7 @@ Vị thế ghi ở một nến được quyết định bằng giá đóng cửa
|
|
|
673
673
|
- Vị thế của nến `t` được khớp tại `Open` của nến `t+1`.
|
|
674
674
|
- Mỗi nến ghi nhận lãi lỗ của vị thế cũ từ giá đóng cửa trước đến giá khớp, rồi của vị thế mới từ giá khớp đến giá đóng cửa.
|
|
675
675
|
- Phí được tính tại nến khớp, trên giá khớp.
|
|
676
|
-
- Chi phí thị trường Việt Nam
|
|
676
|
+
- Chi phí thị trường Việt Nam được tính theo từng khoản, đúng như nút "Run test" trên website QuantVN. Phái sinh VN30, mỗi hợp đồng mỗi chiều: phí giao dịch HNX 2.700 đồng và thuế thu nhập cá nhân 0,1% trên (giá khớp × 100.000 × tỷ lệ ký quỹ ban đầu 17% ÷ 2); thêm phí quản lý vị thế VSDC 2.550 đồng mỗi hợp đồng mỗi ngày cho vị thế còn mở cuối ngày, tính cả ngày nghỉ. Khi chỉ số ở 1.850, một chiều tốn khoảng 0,18 điểm. Cổ phiếu: phí môi giới 0,1% mỗi chiều và thuế 0,1% trên giá trị bán; cổ phiếu mua ngày T bán được từ 13:00 ngày T+2. Phí môi giới phái sinh và chênh lệch giá mua bán không nằm trong các lớp backtest; `paper.simulate` (mục 5.4) có tính.
|
|
677
677
|
- Nếu dữ liệu không có cột `Open`, vị thế được khớp tại giá đóng cửa của nến kế tiếp và thư viện phát cảnh báo.
|
|
678
678
|
|
|
679
679
|
Các bản đến 0.1.25 tính lãi lỗ của vị thế ngay từ giá đóng cửa của chính nến ra quyết định, tức là một mức giá đã qua. Vì vậy **kết quả backtest của cùng một chiến lược sẽ khác so với bản cũ**, nhất là với chiến lược giao dịch nhiều. Con số mới là con số có thể đạt được khi chạy thật; các ví dụ đầu ra bên dưới được tạo từ bản cũ nên chỉ minh họa định dạng.
|
|
@@ -925,7 +925,7 @@ print(result)
|
|
|
925
925
|
print(paper.simulate(df, market="VN_DERIVATIVE", delay_bars=2)) # chậm thêm một nến, gần với chạy thật ở khung 1 phút
|
|
926
926
|
```
|
|
927
927
|
|
|
928
|
-
- Chi phí mặc định lấy theo dịch vụ: phái sinh 1,5 bp mỗi chiều; cổ phiếu 15 bp mỗi chiều, thêm 10 bp thuế khi bán và nửa bước giá cho chênh lệch mua bán.
|
|
928
|
+
- Chi phí mặc định lấy theo dịch vụ: phái sinh 1,5 bp mỗi chiều; cổ phiếu 15 bp mỗi chiều, thêm 10 bp thuế khi bán và nửa bước giá cho chênh lệch mua bán. Mức này gồm cả phí môi giới và chênh lệch giá mua bán nên cao hơn chi phí theo từng khoản của các lớp backtest (mục 4.0).
|
|
929
929
|
- `result.nav` là vốn theo từng nến (bắt đầu từ 1), `result.fills` là các lần khớp, `result.daily` là lợi nhuận theo ngày, `result.stats` gồm lợi nhuận, Sharpe, mức sụt giảm tối đa.
|
|
930
930
|
- `result.notes` ghi rõ những gì mô phỏng này **chưa** tính: quy định T+2 và biên độ giá với cổ phiếu, việc chuyển hợp đồng hằng tháng với phái sinh. Dịch vụ Track Record có áp dụng các quy định đó.
|
|
931
931
|
|
|
@@ -1014,6 +1014,11 @@ Dự án này được phát hành theo giấy phép **MIT License**. Xem file [
|
|
|
1014
1014
|
|
|
1015
1015
|
## Changelog
|
|
1016
1016
|
|
|
1017
|
+
### Version 0.2.1
|
|
1018
|
+
|
|
1019
|
+
- Chi phí của `Backtest_Derivates` và `Backtest_Stock` trùng với website QuantVN: phí HNX, thuế thu nhập cá nhân và phí quản lý vị thế VSDC cho phái sinh; phí 0,1% và thuế bán 0,1% cho cổ phiếu, bán được từ 13:00 ngày T+2 (mục 4.0). Cùng một chiến lược cho cùng một kết quả trong thư viện và khi bấm "Run test"
|
|
1020
|
+
- `paper.simulate` giữ mức phí của dịch vụ Track Record (1,5 bp mỗi chiều cho phái sinh)
|
|
1021
|
+
|
|
1017
1022
|
### Version 0.2.0
|
|
1018
1023
|
|
|
1019
1024
|
- Thêm `quantvn.strategy`: lấy nến theo đúng khung nền tảng dùng, chạy thử chiến lược như khi chạy thật (`replay`), phát hiện nhìn trước tương lai (`check`), kiểm tra file trước khi tải lên (`validate_script`)
|
|
@@ -85,17 +85,21 @@ def test_without_an_open_column_the_fill_is_the_next_close_and_a_warning_is_give
|
|
|
85
85
|
|
|
86
86
|
def test_derivative_fees_follow_the_holding():
|
|
87
87
|
bt = Backtest_Derivates(frame([100, 100, 100, 100], [100, 100, 100, 100], [2, 2, 0, 0]))
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
assert bt.
|
|
91
|
-
|
|
88
|
+
hnx = 2700 / 100000 # exchange fee per contract and side, in index points
|
|
89
|
+
tax = 100 * 0.17 / 2 * 0.001 # 0.1% of half the initial margin on a price of 100
|
|
90
|
+
assert list(bt.df["transaction_fee"]) == pytest.approx([0, 2 * hnx, 0, 2 * hnx]) # in at bar 1, out at bar 3
|
|
91
|
+
assert list(bt.df["tax"]) == pytest.approx([0, 2 * tax, 0, 2 * tax])
|
|
92
|
+
assert bt.df["overnight_fee"].sum() == 0 # flat at the end of the day
|
|
93
|
+
assert bt.PNL().iloc[-1] == pytest.approx(-4 * (hnx + tax))
|
|
94
|
+
# at an index of 1,850 one side costs 0.027 + 0.157 = 0.184 point, i.e. about 18,400 VND per contract
|
|
92
95
|
bt = Backtest_Derivates(frame([1850, 1850, 1850], [1850, 1850, 1850], [1, 1, 1]))
|
|
93
|
-
assert bt.df["transaction_fee"].sum() == pytest.approx(0.
|
|
94
|
-
#
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
bt = Backtest_Derivates(
|
|
98
|
-
assert bt.df["overnight_fee"].sum() ==
|
|
96
|
+
assert (bt.df["transaction_fee"] + bt.df["tax"]).sum() == pytest.approx(0.027 + 0.15725)
|
|
97
|
+
# a contract held at the end of Friday, long or short, pays the position fee for three calendar days
|
|
98
|
+
weekend = pd.concat([frame([100, 100], [100, 100], [-2, -2], "2026-11-13 14:28"),
|
|
99
|
+
frame([100, 100], [100, 100], [-2, 0], "2026-11-16 09:00")], ignore_index=True)
|
|
100
|
+
bt = Backtest_Derivates(weekend)
|
|
101
|
+
assert bt.df["overnight_fee"].sum() == pytest.approx(2 * 3 * 2550 / 100000 + 2 * 2550 / 100000)
|
|
102
|
+
assert bt.df["overnight"].sum() == 1
|
|
99
103
|
|
|
100
104
|
|
|
101
105
|
def test_stock_buys_at_the_next_open_and_pays_its_fee_on_that_price():
|
|
@@ -103,7 +107,18 @@ def test_stock_buys_at_the_next_open_and_pays_its_fee_on_that_price():
|
|
|
103
107
|
assert list(bt.df["trade_qty"]) == [0, 100, 0, -100] and list(bt.df["effective_position"]) == [0, 100, 100, 0]
|
|
104
108
|
raw = 100 * (52 - 51) + 100 * (53 - 52) + 100 * (54 - 53) + 100 * (54 - 54)
|
|
105
109
|
assert bt.df["pnl_raw"].sum() == pytest.approx(raw)
|
|
106
|
-
buy = 100 * 51 * 0.
|
|
107
|
-
sell = 100 * 54 * (0.
|
|
110
|
+
buy = 100 * 51 * 0.001 # broker fee on the fill price
|
|
111
|
+
sell = 100 * 54 * (0.001 + 0.001) # broker fee and the 0.1% tax on sales
|
|
108
112
|
assert list(bt.df["transaction_fee"]) == pytest.approx([0, buy, 0, sell])
|
|
109
113
|
assert bt.df["pnl_after_fees"].sum() == pytest.approx(raw - buy - sell)
|
|
114
|
+
|
|
115
|
+
|
|
116
|
+
def test_stock_bought_on_t_can_be_sold_from_13_00_on_t_plus_2():
|
|
117
|
+
rows = pd.DataFrame({"Date": ["2026-11-09", "2026-11-09", "2026-11-10", "2026-11-11", "2026-11-11", "2026-11-11"],
|
|
118
|
+
"time": ["09:55:00", "10:00:00", "10:00:00", "09:55:00", "10:00:00", "13:00:00"],
|
|
119
|
+
"Open": [50, 50, 52, 54, 54, 55], "Close": [50, 50, 52, 54, 54, 55],
|
|
120
|
+
"position": [100, 100, 100, 0, 0, 0]})
|
|
121
|
+
bt = Backtest_Stock(rows)
|
|
122
|
+
# bought Monday 10:00; the sale decided on Wednesday 09:55 cannot be done at 10:00, it is done at 13:00
|
|
123
|
+
assert list(bt.df["effective_position"]) == [0, 100, 100, 100, 100, 0]
|
|
124
|
+
assert bt.df["transaction_fee"].sum() == pytest.approx(100 * 50 * 0.001 + 100 * 55 * 0.002)
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|