AmiFeed v1.2 tự động lấy giá chứng khoán Việt Nam, chỉ số thế giới, hàng hóa và tỷ giá từ các API công khai, rồi nạp vào AmiBroker, thay cho gói dữ liệu trả phí. Bộ công cụ chạy trên Windows bằng Python, đẩy dữ liệu vào AmiBroker qua OLE.
- Việt Nam: toàn bộ cổ phiếu và ETF trên HOSE, HNX, UPCoM; các chỉ số VNINDEX, VN30, HNX, HNX30, UPCOM; phái sinh VN30F1M, VN30F2M.
- Quốc tế: Dow Jones, S&P 500, Nasdaq, Nikkei 225, KOSPI, Hang Seng, Shanghai Composite, dầu Brent, vàng, DXY, USD/VND.
- Trong phiên: nến hôm nay của HOSE + HNX tự cập nhật mỗi 15 phút từ 9:05 đến 15:05; chốt nến cả 3 sàn lúc 15:15; dữ liệu quốc tế cập nhật lúc 7:05 sáng.
- Nến 1 phút (tùy chọn): cho danh sách mã chọn lọc (VN30, VN100…), giữ được khoảng 3 tháng gần nhất.
- Dự phòng: nguồn chính lỗi thì tự chuyển sang nguồn kế tiếp.
| Nguồn | Đăng nhập | Dùng cho | Lịch sử nến ngày | Ghi chú |
|---|---|---|---|---|
| VNDirect (dchart-api) | Không | Cổ phiếu, chỉ số, phái sinh VN (nguồn chính) | Cổ phiếu từ 01/2013; chỉ số từ 24/08/2017 | Khối lượng có vẻ gồm cả lô lẻ |
| DNSE (Entrade) | Không | Dự phòng 1; VNINDEX đầy đủ | Cổ phiếu từ 03/2012; VNINDEX từ 28/07/2000 | Khối lượng lô chẵn khớp lệnh |
| Vietcap (VCI) | Không | Dự phòng 2; danh sách mã, thành phần rổ | Chưa kiểm tra | Trả giá theo VND, script tự chia 1.000 |
| Yahoo Finance (v8/chart) | Không | Chỉ số thế giới, hàng hóa, tỷ giá | S&P 500 từ 1985; Brent từ 2007; USD/VND từ 2003 | Chỉ cho mục đích cá nhân |
| SSI FastConnect Data | Có (ConsumerID/Secret) | Tùy chọn | — | API chính thức |
Giá cổ phiếu lưu theo nghìn đồng (FPT = 45.0); chỉ số, phái sinh và dữ liệu quốc tế giữ nguyên đơn vị của nguồn. Không có nguồn công khai nào được kiểm tra có cổ phiếu trước 2012, hay HNX, VN30, UPCOM trước 2017.
Yêu cầu và các file trong gói
Cần Windows 10/11, Python 3.9 trở lên, AmiBroker (đã thử với bản 6.20) và kết nối Internet trong nước. Máy phải bật và đăng nhập Windows trong giờ giao dịch.
| File | Tác dụng |
|---|---|
ami_feed.py | Chương trình chính |
config.ini + symbols.txt | Nến ngày HOSE + HNX (cập nhật cả trong phiên) |
config_upcom.ini + symbols_upcom.txt | Nến ngày UPCoM (chỉ cập nhật lúc 15:15) |
config_global.ini + global_symbols.txt | Chỉ số thế giới, hàng hóa, tỷ giá từ Yahoo |
config_1m.ini + symbols_1m.txt | Nến 1 phút (tùy chọn) |
vn_daily.format / vn_intraday.format | Định dạng import, chép vào AmiBroker\Formats |
install.bat | Cài thư viện Python và chép file format |
setup_tasks.bat / remove_tasks.bat | Tạo / xóa 3 lịch chạy tự động |
run_daily_live.bat | Cập nhật HOSE + HNX trong phiên |
run_daily.bat | Chốt nến 15:15: HOSE + HNX, rồi UPCoM |
run_global.bat | Cập nhật dữ liệu quốc tế lúc 7:05 |
run_intraday.bat | Cập nhật nến 1 phút |
test_ole.py | Kiểm tra kết nối AmiBroker từng bước khi gặp lỗi |
test_yahoo.py | Thử nhanh kết nối Yahoo (trả nến tháng, chỉ để kiểm tra) |
requirements.txt | Danh sách thư viện Python |
Mỗi dòng trong file danh sách mã là TÊN_AMIBROKER hoặc TÊN_AMIBROKER MÃ_NGUỒN (ví dụ SP500 ^GSPC). Tên quốc tế dài từ 4 ký tự để không trùng mã cổ phiếu Việt Nam.
Gói phát hành không kèm database. Thư mục output, VN_Daily, VN_1m được tạo khi cài đặt.
Cài đặt trên máy mới
Cài lần đầu mất khoảng 1,5 giờ, phần lớn là thời gian chờ tải lịch sử. Mọi lệnh chạy trong Command Prompt và phải đứng ở C:\AmiFeed>. Nên tạo sẵn shortcut trên Desktop: chuột phải → New → Shortcut, ô location nhập cmd /k cd /d C:\AmiFeed, đặt tên AmiFeed.
- Cài Python từ python.org, nhớ tick Add python.exe to PATH.
- Giải nén gói vào
C:\AmiFeed\. Các file phải nằm trực tiếp trong thư mục này (ví dụC:\AmiFeed\ami_feed.py), không lồng thêm thư mục con. - Chạy
install.bat: chuột phải → Run as administrator. Script cài thư việnrequests,pywin32và chép 2 file.formatvàoAmiBroker\Formats. - Tạo database trong AmiBroker: File → New → Database.
- Database folder:
C:\AmiFeed\VN_Daily - Data source:
(local database), Local data storage:Enable - Base time interval:
End-of-day, Number of bars:15000(để nhận đủ lịch sử S&P 500 từ 1985; đặt thấp hơn sẽ bị cắt nến cũ)
- Database folder:
- Kiểm tra các file
config*.ini: mụcamibroker_dbphải trùng chính xác với Database folder ở bước 4. Mở bằng chuột phải → Open with → Notepad. - Thử các nguồn:
python ami_feed.py test. Kết quả đạt: VNDirect, DNSE, VCI đều có số nến lớn hơn 0 và cùng giá FPT (theo nghìn đồng). - Tạo danh sách mã:
- HOSE + HNX:
python ami_feed.py symbols --boards HSX,HNX --types STOCK,ETF(khoảng 730 mã) - UPCoM:
python ami_feed.py symbols --boards UPCOM --config config_upcom.ini(khoảng 810 mã)
- HOSE + HNX:
- Import thử 3 mã: mở AmiBroker với database
VN_Daily(bằng cách bình thường, không chọn Run as administrator), rồi chạypython ami_feed.py daily --symbols FPT,VNINDEX,VN30F1M --days 30. Dòng cuối phải làDa import ... vao C:\AmiFeed\VN_Daily. - Nạp lịch sử (không thao tác trên AmiBroker trong lúc chạy):
- HOSE + HNX từ 2013:
python ami_feed.py daily --days 5100(khoảng 15 phút) - UPCoM:
python ami_feed.py daily --config config_upcom.ini --days 5100(khoảng 20 phút) - VNINDEX từ 2000:
python ami_feed.py daily --symbols VNINDEX --source dnse --days 9600 - Quốc tế từ 1985:
python ami_feed.py daily --config config_global.ini --days 15000(khoảng 2 phút)
- HOSE + HNX từ 2013:
- Cài lịch tự động: nhấp đúp
setup_tasks.bat(không cần admin). Script tạo 3 task, trạng thái phải là Ready. - Cài đặt nguồn điện: Settings → System → Power, đặt Sleep = Never khi cắm sạc.
- Dọn file tạm: xóa các CSV lớn trong
outputsau khi nạp lịch sử (có thể tới 150–200MB).
Nếu chuyển sang máy mới mà muốn giữ dữ liệu cũ, chép nguyên thư mục VN_Daily (khoảng 160MB) và các file symbols*.txt sang cùng đường dẫn, rồi bỏ qua bước 4, 7 và 9.
| Task | Lịch chạy | Công việc |
|---|---|---|
| AmiFeed Global | 7:05, thứ 3–thứ 7 | Chỉ số thế giới, hàng hóa, tỷ giá (sau khi thị trường Mỹ đóng cửa) |
| AmiFeed Daily Live | 9:05–15:05, mỗi 15 phút, thứ 2–thứ 6 | Nến hôm nay của HOSE + HNX |
| AmiFeed Daily Close | 15:15, thứ 2–thứ 6 | Chốt nến HOSE + HNX rồi UPCoM, bù 7 ngày gần nhất |
Nến 1 phút (tùy chọn)
Chỉ lấy nến 1 phút cho 30–100 mã, vì các nguồn chỉ giữ khoảng 3 tháng và dữ liệu rất nặng.
- Tạo database
C:\AmiFeed\VN_1m: Base time interval =1 minute, Number of bars =100000. Trong Intraday settings: Trading hours 09:00–15:00, Time shift = 0. - Tạo danh sách mã theo rổ:
python ami_feed.py symbols --group VN30 --config config_1m.ini. Có thể dùngVN30,HNX30hoặcVN100. - Mở AmiBroker với database
VN_1m, nạp lịch sử:python ami_feed.py intraday --config config_1m.ini --days 90. - Mở
setup_tasks.batbằng Notepad, bỏ chữREMở 2 dòng về Intraday, lưu lại rồi chạy lại file. Dùng VN100 thì đổi/ri 5thành/ri 10.
Lưu ý: mỗi lần task chạy, AmiBroker sẽ chuyển sang database tương ứng (VN_1m hoặc VN_Daily), nên màn hình đang xem sẽ bị nhảy database. Cách gọn hơn (chưa thử): dùng một database 1 phút duy nhất, bật Allow mixed EOD/intraday data trong Intraday settings, và trỏ cả hai amibroker_db về cùng database đó.
Vận hành
Mỗi ngày chỉ cần mở máy và AmiBroker trước 9:05; các việc còn lại đều tự chạy.
| Tần suất | Việc cần làm | Lệnh |
|---|---|---|
| Hằng ngày, trước 9:05 | Bật máy, đăng nhập Windows, mở AmiBroker với VN_Daily. Không tắt AmiBroker trước 15:30 | — |
| Hằng tuần | Xem log có ERROR hoặc nhiều dòng Khong co du lieu không | powershell -command "Get-Content C:\AmiFeed\output\task.log -Tail 30" |
| Hằng tháng | Cập nhật mã mới niêm yết HOSE + HNX | python ami_feed.py symbols --boards HSX,HNX --types STOCK,ETF |
| Hằng tháng | Cập nhật mã mới UPCoM | python ami_feed.py symbols --boards UPCOM --config config_upcom.ini |
| Hằng tháng | Làm mới giá điều chỉnh sau chia cổ tức | python ami_feed.py daily --days 400 và python ami_feed.py daily --config config_upcom.ini --days 400 |
| Hằng tháng | Xóa CSV cũ hơn 30 ngày | forfiles /p C:\AmiFeed\output /m *.csv /d -30 /c "cmd /c del @path" |
| Tháng 1 và tháng 7 | Cập nhật rổ VN30 sau kỳ cơ cấu (nếu dùng nến 1 phút) | python ami_feed.py symbols --group VN30 --config config_1m.ini |
| Khi cần | Thêm mã quốc tế | Thêm dòng TÊN MÃ_YAHOO vào global_symbols.txt, rồi python ami_feed.py daily --config config_global.ini --symbols TÊN --days 15000 |
Ngày lễ không cần làm gì: task vẫn chạy nhưng không có dữ liệu mới. Máy tắt từ 7 ngày trở xuống thì task 15:15 tự bù (dữ liệu quốc tế bù 10 ngày); lâu hơn thì chạy python ami_feed.py daily --days 30 cho từng file config.
Khi dùng dữ liệu quốc tế trong AFL:
- Lịch nghỉ lễ mỗi nước khác nhau, nên dùng
Foreign("SP500", "C", True)để lấp ngày thiếu bằng giá gần nhất. - Phiên Mỹ ngày D giao dịch sau khi thị trường Việt Nam ngày D đã đóng. Khi backtest tác động của thị trường Mỹ lên phiên Việt Nam hôm sau, dùng
Ref(Foreign("SP500", "C", True), -1)để tránh dùng thông tin chưa có. - Vàng (
GC=F) và dầu Brent (BZ=F) là giá hợp đồng tương lai nối kỳ hạn, có thể có bước nhảy ở ngày chuyển kỳ. USD/VND (VND=X) là tỷ giá thị trường quốc tế, không phải tỷ giá trung tâm NHNN, và đôi khi có nến giật bất thường trước 2010.
Xử lý sự cố
Phần lớn lỗi khi cài đặt đến từ sai thư mục hoặc sai đường dẫn database. Thêm -v vào cuối lệnh để xem log chi tiết.
| Hiện tượng | Nguyên nhân | Cách xử lý |
|---|---|---|
can't open file ...ami_feed.py | Đang đứng sai thư mục (thường là C:\Users\<tên>) | Gõ cd /d C:\AmiFeed trước, hoặc mở bằng shortcut AmiFeed |
The system cannot find the file specified khi copy từ Downloads | File đã được chép rồi, hoặc trình duyệt đổi tên | Chạy dir "%USERPROFILE%\Downloads\tên*" để xem tên thật |
'python' is not recognized | Python chưa vào PATH | Cài lại Python, tick Add to PATH; hoặc ghi đường dẫn đầy đủ (lấy bằng where python) vào các file .bat |
Treo sau dòng Da ghi ... dong | AmiBroker đang hiện popup, hoặc có 2 tiến trình Broker.exe chạy khác quyền | Xem cửa sổ AmiBroker; trong Task Manager tắt hết Broker.exe, mở lại AmiBroker không chọn admin. Dùng python test_ole.py <file.csv> để dò từng bước |
Popup ...WatchLists\index.txt can not be open for writing | amibroker_db trỏ tới thư mục không phải database thật | Sửa amibroker_db trong config cho đúng Database folder |
Invalid class string | AmiBroker chưa đăng ký OLE | Cmd quyền admin: "C:\Program Files\AmiBroker\Broker.exe" /regserver |
Import tra ve ma loi | Thiếu file .format | Chạy lại install.bat bằng quyền admin; xem import.log của AmiBroker |
| Chart S&P 500 chỉ có khoảng 20 năm | Number of bars của database quá thấp | File → Database Settings → Number of bars = 15000, rồi nạp lại lịch sử quốc tế |
Script đọc được 0 ma | File danh sách mã trống | Chạy lại lệnh symbols tương ứng |
Nhiều mã Khong co du lieu cùng lúc | Nguồn đổi API hoặc chặn truy cập | Chạy python ami_feed.py test; đổi thứ tự dòng sources |
| Dữ liệu quốc tế lỗi HTTP 429 | Yahoo giới hạn tần suất | Đợi vài giờ rồi chạy lại; tăng sleep_sec trong config_global.ini |
| Chart không có nến hôm nay | Task không chạy hoặc máy ngủ | Xem task.log; chạy tay python ami_feed.py daily --days 1 |
Tham chiếu lệnh và cấu hình
| Lệnh | Tác dụng |
|---|---|
python ami_feed.py test | Thử các nguồn Việt Nam với mã FPT |
python ami_feed.py symbols --boards HSX,HNX --types STOCK,ETF | Tạo symbols.txt |
python ami_feed.py symbols --boards UPCOM --config config_upcom.ini | Tạo symbols_upcom.txt |
python ami_feed.py symbols --group VN30 --config config_1m.ini | Tạo symbols_1m.txt theo rổ chỉ số |
python ami_feed.py daily [--days N] | Cập nhật nến ngày HOSE + HNX, mặc định lùi 7 ngày |
python ami_feed.py daily --config config_upcom.ini [--days N] | Cập nhật UPCoM |
python ami_feed.py daily --config config_global.ini [--days N] | Cập nhật dữ liệu quốc tế, mặc định lùi 10 ngày |
python ami_feed.py intraday --config config_1m.ini [--days N] | Cập nhật nến 1 phút |
Thêm --symbols FPT,HPG | Chỉ chạy các mã chỉ định (theo tên trong AmiBroker) |
Thêm --source dnse | Ép dùng một nguồn |
Thêm --no-import | Chỉ xuất CSV, không đẩy vào AmiBroker |
Thêm -v | Log chi tiết |
Tham số trong config*.ini | Ý nghĩa | Mặc định |
|---|---|---|
sources | Thứ tự ưu tiên nguồn | vndirect,dnse,vci (quốc tế: yahoo) |
symbols_file | File danh sách mã | symbols.txt, symbols_upcom.txt, global_symbols.txt, symbols_1m.txt |
sleep_sec | Giây chờ giữa các request | 0.3 (quốc tế: 1.0) |
stock_price_multiplier | 1 = nghìn đồng, 1000 = VND | 1 (quốc tế phải giữ 1) |
amibroker_db | Đường dẫn database AmiBroker | C:\AmiFeed\VN_Daily |
lookback_days | Số ngày lùi mỗi lần chạy | 7 (ngày), 10 (quốc tế), 1 (1 phút) |
[vci] price_divisor | Quy đổi giá VCI từ VND | 1000 |
Nên giữ cố định nguồn đứng đầu. VNDirect và DNSE/VCI cho cùng giá nhưng khối lượng lệch khoảng 0,4%, nên trộn nguồn sẽ làm cột khối lượng không đồng nhất giữa các ngày.
Chia sẻ và lưu ý sử dụng
Chỉ chia sẻ mã nguồn và hướng dẫn, không chia sẻ dữ liệu giá.
- Không đính kèm database (
VN_Daily,VN_1m) hay CSV trongoutput. Đó là dữ liệu của các công ty chứng khoán và Yahoo; phân phối lại cần thỏa thuận cấp phép. Mỗi người dùng tự tải dữ liệu về máy mình. - Không để lộ khóa API: nếu đã điền ConsumerID/Secret của SSI thì đổi lại thành
YOUR_CONSUMER_IDtrước khi nén gói. - Rủi ro: các API là endpoint công khai phục vụ web/app, không có tài liệu chính thức, có thể đổi hoặc chặn bất cứ lúc nào, và việc sử dụng có thể không đúng điều khoản của nhà cung cấp. Dữ liệu Yahoo chỉ dùng cho mục đích cá nhân. Công cụ không dành cho mục đích thương mại.
- Khi cập nhật máy đang chạy, chỉ chép đè các file chương trình (
ami_feed.py,.bat,.inimới); không chép đè các filesymbols*.txtvà các file.iniđã sửa tay.
| Ngày | Phiên bản | Thay đổi |
|---|---|---|
| 21/11/2026 | v1.2 | Thêm nguồn Yahoo cho 11 mã quốc tế (chỉ số Mỹ, Nhật, Hàn, Hồng Kông, Trung Quốc; Brent, vàng, DXY, USD/VND); file danh sách mã hỗ trợ cột mã nguồn; thêm UPCoM (config_upcom.ini) và task AmiFeed Global; khuyến nghị Number of bars 15000 |
| 21/11/2026 | v1.1 | Sửa lỗi DNSE cắt lịch sử khi lấy khoảng dài; sửa tên chỉ số HNX, UPCOM; thêm --group lấy mã theo rổ; VNINDEX đầy đủ từ 2000 qua DNSE |
| 21/11/2026 | v1.0 | Bản đầu: VNDirect/DNSE/VCI, nến ngày + 1 phút, cập nhật trong phiên, cài đặt tự động |
Lộ trình phát triển
UPCoM và 11 mã quốc tế đã xong ở v1.2. Các hạng mục còn lại dưới đây là đề xuất, chưa kiểm tra nguồn.
| Nhóm dữ liệu | Ví dụ | Nguồn đề xuất | Trạng thái |
|---|---|---|---|
| Cổ phiếu UPCoM | ~810 mã | VNDirect, DNSE, VCI | Đã xong (v1.2) |
| Chỉ số thế giới, hàng hóa, tiền tệ | 11 mã trong global_symbols.txt | Yahoo Finance | Đã xong (v1.2); thêm mã bằng cách thêm dòng |
| Chứng quyền (CW) | ~480 mã | Các nguồn hiện có | Cần thử; nên dùng database riêng vì mã thay đổi liên tục |
| Tỷ giá trung tâm NHNN | USD/VND trung tâm | Trang công bố tỷ giá của NHNN | Cần kiểm tra; chỉ có 1 giá/ngày, không có nến OHLC |
| Vàng trong nước | SJC | Trang giá vàng SJC | Cần kiểm tra; chỉ có giá mua/bán |
| Lịch sử HNX, VN30, UPCOM trước 2017; cổ phiếu trước 2012 | — | SSI FastConnect hoặc nguồn trả phí | Chưa có nguồn công khai |

