Webhook TradingView cho chứng khoán VN

Chứng khoán Việt Nam là thị trường mà nhiều người muốn tự động hoá nhất, nhưng cũng là thị trường có nhiều quy tắc riêng nhất. Một bot hoạt động tốt trên crypto có thể thất bại hoàn toàn khi áp vào cổ phiếu, không phải vì logic sai mà vì những ràng buộc của thị trường.

Đặc thù khi tự động hoá chứng khoán Việt Nam

Crypto và forex giao dịch liên tục, khối lượng là số thập phân, và giá biến động tự do. Chứng khoán Việt Nam thì ngược lại ở hầu hết các điểm.

Thị trường chỉ mở trong giờ hành chính, chia thành các phiên có tính chất khớp lệnh khác nhau. Khối lượng giao dịch tính theo lô chẵn, thường là bội số của một trăm cổ phiếu. Giá bị giới hạn trong biên độ trần sàn do sàn quy định, và phải đúng bước giá. Cổ phiếu sau khi mua chưa bán được ngay mà phải chờ chu kỳ thanh toán.

Điều quan trọng là những ràng buộc này không phải chi tiết nhỏ. Chúng là điều kiện tiên quyết để lệnh được chấp nhận, nên bot phải kiểm tra chúng trước khi gửi bất kỳ lệnh nào.

Bảng so sánh nhanh giữa ba thị trường:

Yếu tố	Crypto	Forex MT5	Chứng khoán VN
Thời gian giao dịch	24/7	gần 24/5	trong giờ hành chính
Đơn vị khối lượng	số thập phân	lot	lô chẵn
Giới hạn giá	không	không	có trần sàn
Bán ngay sau khi mua	được	được	không, chờ thanh toán

Ba rào cản thực tế và cách vượt qua

Rào cản thứ nhất là truy cập. Không phải công ty chứng khoán nào cũng mở API giao dịch cho khách cá nhân, và điều kiện mở cũng khác nhau. Việc đầu tiên khi muốn làm bot chứng khoán là xác nhận công ty bạn đang dùng có dịch vụ này, và bạn đã đăng ký chưa. Nếu chưa có, mọi nỗ lực viết code đều là làm trước một bước mà không biết có dùng được hay không.

Rào cản thứ hai là khớp lệnh không tức thì như bạn tưởng. Lệnh giới hạn có thể nằm chờ hàng giờ hoặc hàng ngày. Điều này có nghĩa là bot phải quản lý được trạng thái lệnh chờ, biết huỷ lệnh khi hết hiệu lực, và không tính những lệnh chưa khớp vào vị thế.

Rào cản thứ ba là thanh toán. Cổ phiếu mua hôm nay chưa bán được ngay, nên bot không được thiết kế như thể nó có thể mở và đóng vị thế bất cứ lúc nào. Đây là lý do bot chứng khoán thường được thiết kế theo khung ngày hoặc dài hơn, chứ không lướt sóng trong phiên.

Nguồn dữ liệu trên TradingView cho cổ phiếu Việt Nam

TradingView có dữ liệu cổ phiếu Việt Nam, nhưng bạn cần kiểm tra cách viết mã và khung thời gian trước khi dùng.

Về mã, TradingView dùng cách viết chuẩn quốc tế, có thể gồm tiền tố sàn. Bảng giá trong nước và tài khoản chứng khoán của bạn có thể dùng mã ngắn hơn. Vì vậy khi bot nhận tín hiệu, mã trong payload cần được ánh xạ sang mã mà công ty chứng khoán hiểu.

Về khung thời gian, hãy chú ý rằng khung ngày trên TradingView dựa trên dữ liệu phiên đầy đủ. Với thị trường có phiên nghỉ giữa trưa, nến ngày vẫn được tổng hợp theo phiên làm việc, nên tín hiệu trên khung ngày thường chỉ xác nhận sau khi phiên kết thúc. Điều này ảnh hưởng trực tiếp tới thời điểm bot vào lệnh, và bạn nên quyết định trước là vào lệnh ngay trong phiên hay chờ phiên sau.

Về chất lượng dữ liệu, hãy kiểm tra thanh khoản của mã bạn định giao dịch. Với các mã thanh khoản thấp, giá trên chart có thể bị ngắt quãng do không có giao dịch, và tín hiệu từ chỉ báo trên những mã này thường kém tin cậy hơn nhiều so với mã thanh khoản cao.

Kiến trúc hệ thống

Cấu trúc tổng thể không khác các thị trường khác: TradingView phát tín hiệu, server nhận, server gọi API công ty chứng khoán để đặt lệnh.

Điểm khác biệt nằm ở số lớp kiểm tra trước khi gửi lệnh. Với crypto, bot có thể gửi lệnh gần như ngay sau khi đọc payload. Với chứng khoán, bot cần thêm ít nhất bốn bước: kiểm tra mã có hợp lệ, kiểm tra khối lượng có đúng lô chẵn, kiểm tra giá có nằm trong biên độ và đúng bước giá, và kiểm tra thời điểm có nằm trong phiên cho phép.

Ngoài ra nên có thêm hai bước kiểm tra liên quan tới tài khoản: kiểm tra sức mua còn đủ không, và kiểm tra số lượng cổ phiếu khả dụng khi cần bán. Hai bước này tránh việc bot gửi những lệnh chắc chắn bị từ chối.

Chuẩn bị trước khi viết dòng code đầu tiên

Bốn việc cần làm trước.

Thứ nhất, xác nhận công ty chứng khoán của bạn có hỗ trợ API giao dịch và đã đăng ký dịch vụ. Đây là điều kiện chặn, không thể bỏ qua.

Thứ hai, chuẩn bị môi trường thử nếu có. Một số công ty cung cấp môi trường thử nghiệm cho API. Nếu không có, hãy xác định rõ cách kiểm thử an toàn, ví dụ dùng một tài khoản nhỏ với khối lượng tối thiểu.

Thứ ba, lập bảng ánh xạ mã. Bảng này gồm mã theo cách viết của TradingView, mã theo cách công ty chứng khoán yêu cầu, và sàn giao dịch của mã đó. Bảng này sẽ phải cập nhật khi bạn thêm mã mới.

Thứ tư, xác định rõ chiến lược theo khung thời gian nào, và do đó bot vào lệnh vào thời điểm nào trong phiên. Đây là quyết định thiết kế, không phải chi tiết kỹ thuật.

Khối lượng và lô chẵn

Đây là ràng buộc gây lỗi nhiều nhất khi người từ crypto chuyển sang chứng khoán.

Trên thị trường chứng khoán Việt Nam, khối lượng giao dịch khớp lệnh thường theo lô, phổ biến là bội số của một trăm cổ phiếu. Khối lượng nhỏ hơn lô không khớp được theo cách thông thường mà phải giao dịch ở thị trường riêng với thanh khoản kém.

Vì vậy bot phải làm tròn khối lượng xuống bội số của lô, chứ không làm tròn lên. Nếu chiến lược đề xuất mua một trăm năm mươi cổ phiếu, bot mua một trăm. Nếu số vốn chỉ đủ dưới một lô, bot bỏ qua lệnh và ghi log thay vì mua một lô vượt quá rủi ro cho phép.

Một điểm cần kiểm tra thêm là giá trị lệnh tối thiểu. Với một số mã giá thấp, một lô có giá trị rất nhỏ, nhưng với những mã giá cao, một lô có thể đã là khoản tiền đáng kể. Vì vậy khi tính khối lượng theo tỉ lệ vốn, hãy kiểm tra lại rằng một lô không vượt quá tỉ lệ đó.

Giá trần sàn và bước giá

Ba ràng buộc về giá mà bot phải xử lý.

Thứ nhất là biên độ dao động. Mỗi sàn quy định mức tăng giảm tối đa trong ngày so với giá tham chiếu. Bot không được gửi lệnh mua ở giá cao hơn giá trần hay lệnh bán ở giá thấp hơn giá sàn.

Thứ hai là bước giá. Mỗi sàn quy định bước nhảy tối thiểu của giá, và bước này có thể thay đổi theo mức giá của mã. Lệnh có giá không đúng bước sẽ bị từ chối.

Thứ ba là giá tham chiếu. Giá tham chiếu của ngày hôm nay là giá đóng cửa của phiên trước, trừ những ngày có sự kiện như chia cổ tức thì giá tham chiếu được điều chỉnh. Vì vậy bot không nên tự tính giá tham chiếu mà phải đọc từ dữ liệu công ty chứng khoán cung cấp.

Ràng buộc	Cách kiểm tra	Nếu vi phạm
Biên độ trần sàn	giá nằm giữa giá sàn và giá trần	lệnh bị từ chối
Bước giá	giá chia hết cho bước giá	lệnh bị từ chối
Giá tham chiếu	đọc từ dữ liệu công ty	tính sai trần sàn
Khối lượng lô chẵn	khối lượng là bội số của lô	lệnh bị từ chối
Sức mua	kiểm tra trước khi gửi	lệnh bị từ chối

Phiên giao dịch và thời điểm vào lệnh

Một phiên giao dịch chứng khoán Việt Nam có cấu trúc riêng, và mỗi phần của phiên có đặc tính khớp lệnh khác nhau.

Buổi sáng thường bắt đầu bằng phiên mở cửa, nơi lệnh được khớp theo cơ chế tập trung để xác định giá mở cửa. Sau đó tới phiên khớp liên tục, nơi lệnh được khớp ngay khi có lệnh đối ứng. Buổi chiều tiếp tục phiên khớp liên tục, rồi kết thúc bằng phiên đóng cửa xác định giá đóng cửa.

Với bot, phiên khớp liên tục là nơi an toàn nhất để gửi lệnh giới hạn, vì bạn kiểm soát được giá và không phụ thuộc vào cơ chế khớp tập trung. Lệnh thị trường trong phiên mở cửa và phiên đóng cửa có thể cho giá khớp rất khác dự kiến, đặc biệt với mã thanh khoản thấp.

Một quy tắc thực tế nên áp dụng: bot không nên gửi lệnh trong vài phút đầu của phiên, vì giá biến động mạnh và thanh khoản chưa ổn định, cũng như không nên gửi trong vài phút cuối phiên. Hãy dành một khoảng đệm ở hai đầu phiên.

Chuẩn bị cho phiên đóng cửa và cuối ngày

Phiên đóng cửa là thời điểm quan trọng nhất trong ngày với bot, và cũng là thời điểm dễ phát sinh lỗi nhất.

Ba việc bot nên làm trước khi phiên kết thúc. Thứ nhất, huỷ những lệnh giới hạn chưa khớp nếu chiến lược không muốn giữ chúng qua ngày. Thứ hai, ghi lại trạng thái cuối ngày gồm danh sách vị thế, danh sách lệnh chờ và số dư. Thứ ba, đối chiếu trạng thái bot tin rằng nó đang giữ với dữ liệu từ công ty chứng khoán, và ghi log nếu có sai lệch.

Một việc nữa rất đáng làm là báo cáo cuối ngày gửi tới kênh bạn thường dùng. Báo cáo gồm tín hiệu nhận được trong ngày, lệnh đã đặt, lệnh đã khớp, lệnh còn chờ, và lãi lỗ tạm tính. Đây là cách phát hiện sớm những bất thường mà log chi tiết khó thể hiện.

Sự kiện doanh nghiệp ảnh hưởng tới tín hiệu

Đây là yếu tố đặc thù của chứng khoán và là nguyên nhân của nhiều tín hiệu giả.

Khi doanh nghiệp chia cổ tức bằng tiền hoặc bằng cổ phiếu, hoặc phát hành thêm, giá tham chiếu của ngày giao dịch không hưởng quyền sẽ được điều chỉnh. Trên chart, giá giảm đột ngột so với phiên trước. Với các chỉ báo dựa trên giá như đường trung bình hay biên độ, sự kiện này tạo ra biến động giả và có thể phát tín hiệu mua hoặc bán không nên có.

Cách xử lý gồm ba phần. Một là duy trì danh sách ngày sự kiện của các mã bạn đang theo dõi, lấy từ lịch sự kiện của công ty chứng khoán. Hai là tạm dừng bot cho mã đó trong vài phiên quanh ngày sự kiện. Ba là ghi lại những lần tạm dừng này, để khi phân tích hiệu quả, bạn không so sánh khoảng thời gian có sự kiện với khoảng thời gian bình thường.

Một chi tiết nữa là cổ phiếu có thể bị tạm ngừng giao dịch, bị đưa vào diện cảnh báo hoặc bị kiểm soát. Bot nên kiểm tra trạng thái mã trước khi gửi lệnh, và bỏ qua nếu mã không còn ở trạng thái giao dịch bình thường.

Quản lý vị thế khi chưa bán được

Vì cổ phiếu mua chưa bán được ngay, bot phải phân biệt hai khái niệm: khối lượng cổ phiếu trong tài khoản và khối lượng khả dụng để bán.

Ba tình huống cần xử lý rõ. Thứ nhất, tín hiệu đóng vị thế xuất hiện nhưng khối lượng khả dụng không đủ. Cách xử lý an toàn là ghi log, đánh dấu tín hiệu này là chưa xử lý, và thử lại khi cổ phiếu về tài khoản. Thứ hai, tín hiệu đóng vị thế xuất hiện và khối lượng khả dụng đủ một phần. Cách xử lý là bán phần khả dụng nếu chiến lược cho phép, hoặc chờ đủ nếu không. Thứ ba, có nhiều tín hiệu đóng vị thế trong khi vị thế chưa thể đóng. Cách xử lý là chỉ ghi nhận một tín hiệu chờ và bỏ qua các tín hiệu lặp.

Một điều quan trọng là bot phải nhất quán giữa khối lượng mua và khối lượng bán. Nếu bot mua một trăm cổ phiếu nhưng cố bán một trăm hai mươi, lệnh bán sẽ bị từ chối một phần hoặc toàn bộ, và trạng thái nội bộ của bot sẽ lệch với thực tế.

Ví dụ luồng một lệnh mua cổ phiếu

Để hình dung toàn bộ, hãy đi qua một ví dụ với mã FPT và chiến lược khung ngày.

Tín hiệu xuất hiện khi nến ngày đóng, nghĩa là sau khi phiên kết thúc. Bot nhận payload có mã, hành động mua, giá đóng cửa và mã tín hiệu. Bot kiểm tra mã có trong bảng ánh xạ, kiểm tra mã đang ở trạng thái giao dịch bình thường, và kiểm tra không có sự kiện doanh nghiệp sắp tới.

Sau đó bot tính khối lượng từ số vốn phân bổ và giá dự kiến, làm tròn xuống bội số của lô, và kiểm tra giá trị có vượt tỉ lệ cho phép hay không. Bot kiểm tra sức mua còn đủ. Nếu tất cả đều đạt, bot chuẩn bị lệnh giới hạn với giá được chọn theo quy tắc của chiến lược, làm tròn theo bước giá, và kiểm tra giá nằm trong biên độ trần sàn của phiên hôm sau.

Vì tín hiệu đến sau khi phiên đóng, lệnh sẽ được gửi vào phiên tiếp theo. Bot đặt lệnh giới hạn, chờ trong phiên, và nếu sau một khoảng thời gian cấu hình mà lệnh chưa khớp, bot quyết định huỷ hoặc điều chỉnh giá theo quy tắc đã định. Mọi bước đều được ghi log để bạn có thể tái hiện lại quyết định sau này.

Lỗi hay gặp và cách xử lý

Lỗi thứ nhất là khối lượng không đúng lô chẵn. Dấu hiệu là lệnh bị từ chối với lý do khối lượng không hợp lệ.

Lỗi thứ hai là giá sai bước giá. Dấu hiệu là lệnh bị từ chối dù giá có vẻ hợp lý theo mắt người.

Lỗi thứ ba là gửi lệnh ngoài giờ giao dịch. Dấu hiệu là lệnh bị từ chối toàn bộ, thường xảy ra khi bot tính giờ sai hoặc không quy đổi múi giờ.

Lỗi thứ tư là mã không tồn tại hoặc đã bị đổi trạng thái. Dấu hiệu là lỗi không tìm thấy sản phẩm.

Lỗi thứ năm là cố bán nhiều hơn khối lượng khả dụng. Dấu hiệu là lệnh bán bị từ chối một phần.

Lỗi thứ sáu là không huỷ lệnh chờ cuối ngày, dẫn tới việc bot tin rằng nó đã vào vị thế trong khi thực tế lệnh chưa khớp và đã bị huỷ tự động.

Lỗi thứ bảy là không xử lý sự kiện doanh nghiệp, dẫn tới tín hiệu giả ngay sau ngày giao dịch không hưởng quyền.

Checklist trước khi chạy bot chứng khoán

• Đã xác nhận công ty chứng khoán hỗ trợ API giao dịch và bạn đã đăng ký dịch vụ.
• Bảng ánh xạ mã đã đúng, đã kiểm tra bằng danh sách sản phẩm thật.
• Khối lượng luôn được làm tròn xuống bội số của lô chẵn, và bỏ qua nếu nhỏ hơn một lô.
• Giá luôn được làm tròn theo bước giá và kiểm tra nằm trong biên độ trần sàn.
• Bot kiểm tra sức mua trước khi mua và khối lượng khả dụng trước khi bán.
• Có khoảng đệm không giao dịch ở đầu và cuối phiên.
• Có danh sách ngày sự kiện doanh nghiệp và tạm dừng đúng mã trong khoảng thời gian đó.
• Có bước huỷ lệnh chờ và đối chiếu trạng thái cuối ngày.
• Có giới hạn khối lượng tối đa, số mã tối đa và tỉ lệ vốn tối đa.
• Có cơ chế chống trùng theo mã tín hiệu.
• Đã chạy thử với khối lượng tối thiểu trên một tài khoản nhỏ.
• Có báo cáo cuối ngày gửi tới kênh bạn thường dùng.

Đo hiệu quả bot chứng khoán cho đúng

Vì chu kỳ giao dịch chứng khoán dài hơn crypto và forex, cách đo hiệu quả cũng phải khác.

Ba sai lầm thường gặp khi đánh giá. Thứ nhất là đánh giá sau vài ngày. Với chiến lược khung ngày, vài ngày chỉ là vài lệnh, hoàn toàn không đủ để kết luận. Thứ hai là đánh giá chỉ bằng lãi lỗ, mà bỏ qua tỉ lệ lệnh bị từ chối và tỉ lệ lệnh không khớp, vì hai chỉ số này cho biết hệ thống có vận hành đúng hay không. Thứ ba là so sánh kết quả với việc giao dịch tay trong cùng khoảng thời gian, vì cảm giác của bạn về việc giao dịch tay thường lạc quan hơn thực tế.

Bốn chỉ số nên theo dõi. Một là số tín hiệu nhận được so với số lệnh được đặt, để phát hiện lỗi ở khâu kiểm tra. Hai là tỉ lệ lệnh khớp trên tổng số lệnh gửi, để phát hiện vấn đề về giá đặt. Ba là số lần bot phải chờ cổ phiếu về mới đóng được vị thế, để biết chiến lược có bị ảnh hưởng bởi chu kỳ thanh toán hay không. Bốn là lãi lỗ sau khi trừ phí và thuế.

Một điều đáng làm là ghi lại nhật ký quyết định: mỗi lệnh, bot dựa trên tín hiệu nào, kiểm tra gì, và vì sao chọn mức giá đó. Nhật ký này giúp bạn phân biệt lỗi hệ thống với giai đoạn thị trường không thuận lợi, hai thứ cần cách xử lý hoàn toàn khác nhau.

Ba câu hỏi trước khi mở rộng sang nhiều mã

Khi bot đã chạy ổn trên một mã, nhu cầu tiếp theo là thêm mã khác. Trước khi làm, hãy trả lời ba câu hỏi.

Câu thứ nhất: tổng vốn dành cho bot là bao nhiêu, và mỗi mã được dùng tối đa bao nhiêu phần trăm. Trả lời được câu này thì bạn biết ngay mã thứ mười có khả thi hay không, vì rất nhiều trường hợp một lô cổ phiếu đã vượt quá hạn mức cho phép của mã đó.

Câu thứ hai: các mã bạn định thêm có tương quan với nhau không. Nếu tất cả đều thuộc cùng một nhóm ngành, bot của bạn thực chất chỉ đang mở một vị thế lớn dưới nhiều cái tên khác nhau, và rủi ro không được phân tán như bạn nghĩ.

Câu thứ ba: bạn có đủ thời gian đọc báo cáo cuối ngày khi số mã tăng lên không. Nếu không, hãy giữ danh sách ở mức bạn thực sự theo dõi được, vì một bot chạy nhiều mã mà không ai đọc báo cáo còn rủi ro hơn một bot chạy ít mã nhưng được giám sát.

Kết luận

Tự động hoá chứng khoán Việt Nam không khó về mặt kỹ thuật, nhưng đòi hỏi tôn trọng các quy tắc của thị trường: lô chẵn, bước giá, biên độ trần sàn, giờ giao dịch, chu kỳ thanh toán và sự kiện doanh nghiệp. Khi bot kiểm tra đủ những điều kiện này trước khi gửi lệnh, tỉ lệ lệnh bị từ chối sẽ giảm xuống rất thấp.

Về lộ trình, một cách làm hợp lý là bắt đầu với crypto để làm quen toàn bộ luồng webhook, sau đó mở rộng sang chứng khoán với những kiểm tra bổ sung. Phần nhận webhook, xác thực, chống trùng và ghi log dùng lại được, nên công việc thêm chủ yếu nằm ở module thực thi.

Nếu bạn muốn nối webhook TradingView vào cả MT5, Binance và chứng khoán Việt Nam trong một lộ trình có hướng dẫn từng buổi, hãy xem Bootcamp TradingView Webhook Bot của Hướng Nghiệp AI.

Đọc tiếp trong chuỗi: webhook TradingView sang Binance, webhook TradingView sang MT5, bảo mật webhook TradingView và VPS chạy bot TradingView Webhook 24/7.