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.
Files changed (51) hide show
  1. {quantvn-0.2.0/quantvn.egg-info → quantvn-0.2.1}/PKG-INFO +8 -3
  2. {quantvn-0.2.0 → quantvn-0.2.1}/README.md +7 -2
  3. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/metrics/_fills.py +40 -3
  4. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/metrics/backtest.py +13 -25
  5. {quantvn-0.2.0 → quantvn-0.2.1/quantvn.egg-info}/PKG-INFO +8 -3
  6. {quantvn-0.2.0 → quantvn-0.2.1}/setup.py +1 -1
  7. {quantvn-0.2.0 → quantvn-0.2.1}/tests/test_backtests.py +27 -12
  8. {quantvn-0.2.0 → quantvn-0.2.1}/LICENSE +0 -0
  9. {quantvn-0.2.0 → quantvn-0.2.1}/MANIFEST.in +0 -0
  10. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/__init__.py +0 -0
  11. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/__init__.py +0 -0
  12. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/data/__init__.py +0 -0
  13. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/data/derivatives.py +0 -0
  14. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/data/download.py +0 -0
  15. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/metrics/__init__.py +0 -0
  16. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/metrics/backtest.py +0 -0
  17. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/crypto/metrics/metrics.py +0 -0
  18. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/metrics/__init__.py +0 -0
  19. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/metrics/portfolio.py +0 -0
  20. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/metrics/single_asset.py +0 -0
  21. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/metrics/st.py +0 -0
  22. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/paper/__init__.py +0 -0
  23. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/paper/client.py +0 -0
  24. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/paper/portfolio.py +0 -0
  25. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/paper/single_asset.py +0 -0
  26. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/strategy/__init__.py +0 -0
  27. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/strategy/frames.py +0 -0
  28. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/strategy/harness.py +0 -0
  29. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/strategy/script.py +0 -0
  30. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/us/__init__.py +0 -0
  31. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/us/data/__init__.py +0 -0
  32. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/us/data/stocks.py +0 -0
  33. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/us/metrics/__init__.py +0 -0
  34. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/us/metrics/backtest.py +0 -0
  35. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/__init__.py +0 -0
  36. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/__init__.py +0 -0
  37. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/const.py +0 -0
  38. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/core.py +0 -0
  39. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/derivatives.py +0 -0
  40. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/macro.py +0 -0
  41. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/stocks.py +0 -0
  42. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/data/utils.py +0 -0
  43. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/metrics/__init__.py +0 -0
  44. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn/vn/metrics/metrics.py +0 -0
  45. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn.egg-info/SOURCES.txt +0 -0
  46. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn.egg-info/dependency_links.txt +0 -0
  47. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn.egg-info/requires.txt +0 -0
  48. {quantvn-0.2.0 → quantvn-0.2.1}/quantvn.egg-info/top_level.txt +0 -0
  49. {quantvn-0.2.0 → quantvn-0.2.1}/setup.cfg +0 -0
  50. {quantvn-0.2.0 → quantvn-0.2.1}/tests/test_paper.py +0 -0
  51. {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.0
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 dùng cùng mức với dịch vụ Track Record. Phái sinh VN30: 1,5 bp giá trị hợp đồng mỗi chiều (phí sở, phí bù trừ, thuế, môi giới và nửa bước giá), khoảng 0,28 điểm khi chỉ số ở 1.850. Cổ phiếu: 0,15% mỗi chiều, thêm 0,1% thuế khi bán và nửa bước giá. Các bản cũ chỉ tính phí sở 2.700 đồng cho phái sinh, khoảng một phần mười chi phí thực.
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 dùng cùng mức với dịch vụ Track Record. Phái sinh VN30: 1,5 bp giá trị hợp đồng mỗi chiều (phí sở, phí bù trừ, thuế, môi giới và nửa bước giá), khoảng 0,28 điểm khi chỉ số ở 1.850. Cổ phiếu: 0,15% mỗi chiều, thêm 0,1% thuế khi bán và nửa bước giá. Các bản cũ chỉ tính phí sở 2.700 đồng cho phái sinh, khoảng một phần mười chi phí thực.
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
- # Costs of the Vietnamese markets, the same values the QuantVN Track Record service charges.
22
- # VN30 futures, per side, as a fraction of the contract's value: exchange fee 2,700 VND, clearing fee
23
- # 2,550 VND and personal income tax of 0.1% on half the initial margin come to about 1.1 bp at an index of
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 (VN_FUTURES_FEE, VN_STOCK_FEE, VN_STOCK_SELL_TAX, fill_price,
7
- held_after_next_open, next_bar_pnl, vn_tick)
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, in index points per contract: every contract traded pays VN_FUTURES_FEE of the fill price
68
- # (exchange fee, clearing fee, tax, commission and half a price step; see quantvn.metrics._fills).
69
- # Until 0.1.25 only the exchange fee of 2,700 VND was charged per trade, about a tenth of the real
70
- # cost, and the clearing fee was booked as a daily holding fee on long positions.
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,15% mỗi chiều, thuế 0,1% khi bán,
247
- # và nửa bước giá cho chênh lệch mua bán (cùng mức với dịch vụ Track Record).
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
- half_step = np.array([vn_tick(p) / 2 if np.isfinite(p) else 0.0 for p in fill])
251
- self.df["transaction_fee"] = (np.abs(qty) * fill * VN_STOCK_FEE
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
- # Đủ điều kiện nếu số PHIÊN đã qua >= min_hold_days
323
- if (int(day_id[i]) - int(d_entry)) >= min_hold_days:
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.0
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 dùng cùng mức với dịch vụ Track Record. Phái sinh VN30: 1,5 bp giá trị hợp đồng mỗi chiều (phí sở, phí bù trừ, thuế, môi giới và nửa bước giá), khoảng 0,28 điểm khi chỉ số ở 1.850. Cổ phiếu: 0,15% mỗi chiều, thêm 0,1% thuế khi bán và nửa bước giá. Các bản cũ chỉ tính phí sở 2.700 đồng cho phái sinh, khoảng một phần mười chi phí thực.
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`)
@@ -2,7 +2,7 @@ from setuptools import find_packages, setup
2
2
 
3
3
  setup(
4
4
  name="quantvn",
5
- version="0.2.0",
5
+ version="0.2.1",
6
6
  packages=find_packages(),
7
7
  install_requires=[
8
8
  "requests",
@@ -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
- fee = 100 * 1.5e-4 # 1.5 bp of the fill price, per contract and side
89
- assert list(bt.df["transaction_fee"]) == pytest.approx([0, 2 * fee, 0, 2 * fee]) # in at bar 1, out at bar 3
90
- assert bt.PNL().iloc[-1] == pytest.approx(-4 * fee)
91
- # at an index of 1,850 one side costs about 0.28 point, i.e. 27,750 VND per contract
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.2775)
94
- # holding overnight, long or short, has no fee of its own
95
- two_days = pd.concat([frame([100, 100], [100, 100], [-1, -1], "2026-11-12 14:28"),
96
- frame([100, 100], [100, 100], [-1, 0], "2026-11-13 09:00")], ignore_index=True)
97
- bt = Backtest_Derivates(two_days)
98
- assert bt.df["overnight_fee"].sum() == 0 and bt.df["overnight"].sum() == 1
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.0015 + 100 * 0.05 # commission, and half of a 100 VND step per share
107
- sell = 100 * 54 * (0.0015 + 0.0010) + 100 * 0.05 # commission, sell tax, half a step
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