AmiFeed – Hướng dẫn cài đặt & vận hành

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ậpDùng choLịch sử nến ngàyGhi chú
VNDirect (dchart-api)KhôngCổ phiếu, chỉ số, phái sinh VN (nguồn chính)Cổ phiếu từ 01/2013; chỉ số từ 24/08/2017Khối lượng có vẻ gồm cả lô lẻ
DNSE (Entrade)KhôngDự phòng 1; VNINDEX đầy đủCổ phiếu từ 03/2012; VNINDEX từ 28/07/2000Khối lượng lô chẵn khớp lệnh
Vietcap (VCI)KhôngDự phòng 2; danh sách mã, thành phần rổChưa kiểm traTrả giá theo VND, script tự chia 1.000
Yahoo Finance (v8/chart)KhôngChỉ số thế giới, hàng hóa, tỷ giáS&P 500 từ 1985; Brent từ 2007; USD/VND từ 2003Chỉ cho mục đích cá nhân
SSI FastConnect DataCó (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.

Tải AmiFeed_v1.2.zip

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.

FileTác dụng
ami_feed.pyChương trình chính
config.ini + symbols.txtNến ngày HOSE + HNX (cập nhật cả trong phiên)
config_upcom.ini + symbols_upcom.txtNến ngày UPCoM (chỉ cập nhật lúc 15:15)
config_global.ini + global_symbols.txtChỉ số thế giới, hàng hóa, tỷ giá từ Yahoo
config_1m.ini + symbols_1m.txtNế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.batCài thư viện Python và chép file format
setup_tasks.bat / remove_tasks.batTạo / xóa 3 lịch chạy tự động
run_daily_live.batCập nhật HOSE + HNX trong phiên
run_daily.batChốt nến 15:15: HOSE + HNX, rồi UPCoM
run_global.batCập nhật dữ liệu quốc tế lúc 7:05
run_intraday.batCập nhật nến 1 phút
test_ole.pyKiểm tra kết nối AmiBroker từng bước khi gặp lỗi
test_yahoo.pyThử nhanh kết nối Yahoo (trả nến tháng, chỉ để kiểm tra)
requirements.txtDanh 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.

  1. Cài Python từ python.org, nhớ tick Add python.exe to PATH.
  2. 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.
  3. Chạy install.bat: chuột phải → Run as administrator. Script cài thư viện requests, pywin32 và chép 2 file .format vào AmiBroker\Formats.
  4. 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ũ)
  5. Kiểm tra các file config*.ini: mục amibroker_db phải trùng chính xác với Database folder ở bước 4. Mở bằng chuột phải → Open with → Notepad.
  6. 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).
  7. 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ã)
  8. 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ạy python ami_feed.py daily --symbols FPT,VNINDEX,VN30F1M --days 30. Dòng cuối phải là Da import ... vao C:\AmiFeed\VN_Daily.
  9. 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)
  10. 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.
  11. Cài đặt nguồn điện: Settings → System → Power, đặt Sleep = Never khi cắm sạc.
  12. Dọn file tạm: xóa các CSV lớn trong output sau 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.

TaskLịch chạyCông việc
AmiFeed Global7:05, thứ 3–thứ 7Chỉ số thế giới, hàng hóa, tỷ giá (sau khi thị trường Mỹ đóng cửa)
AmiFeed Daily Live9:05–15:05, mỗi 15 phút, thứ 2–thứ 6Nến hôm nay của HOSE + HNX
AmiFeed Daily Close15:15, thứ 2–thứ 6Chố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.

  1. 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.
  2. Tạo danh sách mã theo rổ: python ami_feed.py symbols --group VN30 --config config_1m.ini. Có thể dùng VN30,HNX30 hoặc VN100.
  3. Mở AmiBroker với database VN_1m, nạp lịch sử: python ami_feed.py intraday --config config_1m.ini --days 90.
  4. Mở setup_tasks.bat bằ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 5 thà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ấtViệc cần làmLệnh
Hằng ngày, trước 9:05Bậ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ầnXem log có ERROR hoặc nhiều dòng Khong co du lieu khôngpowershell -command "Get-Content C:\AmiFeed\output\task.log -Tail 30"
Hằng thángCập nhật mã mới niêm yết HOSE + HNXpython ami_feed.py symbols --boards HSX,HNX --types STOCK,ETF
Hằng thángCập nhật mã mới UPCoMpython ami_feed.py symbols --boards UPCOM --config config_upcom.ini
Hằng thángLàm mới giá điều chỉnh sau chia cổ tứcpython ami_feed.py daily --days 400 và python ami_feed.py daily --config config_upcom.ini --days 400
Hằng thángXóa CSV cũ hơn 30 ngàyforfiles /p C:\AmiFeed\output /m *.csv /d -30 /c "cmd /c del @path"
Tháng 1 và tháng 7Cậ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ầnThê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ượngNguyên nhânCá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ừ DownloadsFile đã được chép rồi, hoặc trình duyệt đổi tênChạy dir "%USERPROFILE%\Downloads\tên*" để xem tên thật
'python' is not recognizedPython chưa vào PATHCà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 ... dongAmiBroker đang hiện popup, hoặc có 2 tiến trình Broker.exe chạy khác quyềnXem 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 writingamibroker_db trỏ tới thư mục không phải database thậtSửa amibroker_db trong config cho đúng Database folder
Invalid class stringAmiBroker chưa đăng ký OLECmd quyền admin: "C:\Program Files\AmiBroker\Broker.exe" /regserver
Import tra ve ma loiThiếu file .formatChạ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ămNumber of bars của database quá thấpFile → Database Settings → Number of bars = 15000, rồi nạp lại lịch sử quốc tế
Script đọc được 0 maFile danh sách mã trốngChạy lại lệnh symbols tương ứng
Nhiều mã Khong co du lieu cùng lúcNguồn đổi API hoặc chặn truy cậpChạy python ami_feed.py test; đổi thứ tự dòng sources
Dữ liệu quốc tế lỗi HTTP 429Yahoo 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 nayTask 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ệnhTác dụng
python ami_feed.py testThử các nguồn Việt Nam với mã FPT
python ami_feed.py symbols --boards HSX,HNX --types STOCK,ETFTạo symbols.txt
python ami_feed.py symbols --boards UPCOM --config config_upcom.iniTạo symbols_upcom.txt
python ami_feed.py symbols --group VN30 --config config_1m.iniTạ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,HPGChỉ 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-importChỉ xuất CSV, không đẩy vào AmiBroker
Thêm -vLog chi tiết
Tham số trong config*.iniÝ nghĩaMặc định
sourcesThứ tự ưu tiên nguồnvndirect,dnse,vci (quốc tế: yahoo)
symbols_fileFile danh sách mãsymbols.txt, symbols_upcom.txt, global_symbols.txt, symbols_1m.txt
sleep_secGiây chờ giữa các request0.3 (quốc tế: 1.0)
stock_price_multiplier1 = nghìn đồng, 1000 = VND1 (quốc tế phải giữ 1)
amibroker_dbĐường dẫn database AmiBrokerC:\AmiFeed\VN_Daily
lookback_daysSố ngày lùi mỗi lần chạy7 (ngày), 10 (quốc tế), 1 (1 phút)
[vci] price_divisorQuy đổi giá VCI từ VND1000

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 trong output. Đó 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_ID trướ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, .ini mới); không chép đè các file symbols*.txt và các file .ini đã sửa tay.
NgàyPhiên bảnThay đổi
21/11/2026v1.2Thê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/2026v1.1Sử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/2026v1.0Bả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ệuVí dụNguồn đề xuấtTrạ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.txtYahoo 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 NHNNUSD/VND trung tâmTrang công bố tỷ giá của NHNNCần kiểm tra; chỉ có 1 giá/ngày, không có nến OHLC
Vàng trong nướcSJCTrang giá vàng SJCCầ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

Tags: ,

0 0 votes
Article Rating
Subscribe
Notify of
guest

0 Comments
Oldest
Newest Most Voted
Inline Feedbacks
View all comments