Bộ lọc tin tức miễn phí cho EA MT4/MT5: API NinjaBull hoạt động thế nào

EA của bạn giao dịch dựa trên những gì nó thấy trên biểu đồ, còn tin tức kinh tế như dữ liệu việc làm Mỹ hay quyết định của ngân hàng trung ương không bao giờ đến được đoạn code. API NinjaBull bổ sung phần tin tức đó dưới dạng một tín hiệu mà EA của bạn có thể đọc. NinjaBull là một trong những công cụ miễn phí do ForexFanClub vận hành.

API NinjaBull lọc lệnh cho EA của bạn như thế nào?

EA của bạn kiểm tra tín hiệu trước mỗi lệnh mới và bỏ qua những lệnh đi ngược với phân tích. AI của NinjaBull đọc dữ liệu kinh tế, tin tức và biểu đồ mới nhất của vàng (XAU/USD) và Bitcoin (BTC/USD) rồi gom kết quả thành một tín hiệu. Quy tắc vào lệnh theo kỹ thuật của bạn vẫn giữ nguyên, API chỉ quyết định EA của bạn sẽ bỏ qua những lệnh nào.

• Tín hiệu BUY
  Phân tích nghiêng về mua. EA của bạn vào các lệnh mua và bỏ qua lệnh bán.
• Tín hiệu SELL
  Phân tích nghiêng về bán. EA của bạn vào các lệnh bán và bỏ qua lệnh mua.
• Tín hiệu WAIT
  Phân tích không cho hướng đi rõ ràng, nên EA không mở lệnh mới.

Hãy chuẩn bị tinh thần cho nhiều tín hiệu WAIT. Trong đợt chạy thử của chúng tôi từ ngày 3 đến 6/11, 33 trong 64 lần phân tích vàng cho WAIT, 19 lần cho SELL và 12 lần cho BUY. Với Bitcoin, 26 trong 50 lần phân tích cho WAIT, 23 lần cho SELL và 1 lần cho BUY. Vì vậy, một EA chỉ giao dịch theo tín hiệu sẽ đứng ngoài thị trường trong phần lớn thời gian của tuần.

score (điểm số) bổ sung bộ lọc thứ hai. Gần 0 nghĩa là áp lực bán mạnh, gần 100 nghĩa là áp lực mua mạnh, còn 50 là trung lập.

Ví dụ, EA của bạn có thể chỉ vào lệnh bán khi điểm số từ 45 trở xuống. Ngưỡng càng chặt thì càng ít lệnh, nên hãy thử ngưỡng của bạn trên tài khoản demo trước khi dùng ngưỡng đó với tiền thật.

Gọi API NinjaBull như thế nào?

EA của bạn gửi một yêu cầu GET đến địa chỉ API với hai tham số, key và pair. Bạn không cần header bổ sung và không cần đăng nhập. Địa chỉ API là:

https://fxfan.club/vi/ninjabull/api_ea.php

Mục	Giá trị
Phương thức	HTTP GET
Xác thực	Tham số key (bắt buộc)
Định dạng dữ liệu	JSON

• key
  API vẫn đang ở giai đoạn beta, nên mọi người dùng chung một key, NINJABULL_VIP_2026. Bạn không cần đăng ký hay chờ phê duyệt.
• pair
  API hoạt động với XAU/USD và BTC/USD, viết có dấu gạch chéo. Các cặp khác sẽ trả về lỗi.

Một yêu cầu cho vàng trông như sau:

https://fxfan.club/vi/ninjabull/api_ea.php?key=NINJABULL_VIP_2026&pair=XAU/USD

Trước khi EA của bạn gọi được địa chỉ này, MT4 hoặc MT5 phải cho phép kết nối. Mở Tools, rồi Options, rồi thẻ Expert Advisors, tích vào Allow WebRequest for listed URL, và thêm https://fxfan.club.

Chúng tôi dự định sau này sẽ thay key dùng chung bằng key riêng cho từng người dùng. Vì vậy, hãy đặt key trong một biến input của EA thay vì viết key thẳng vào code. Khi key thay đổi, bạn chỉ cần đổi một thiết lập và không phải sửa EA.

API NinjaBull trả về gì?

API trả về một phản hồi JSON ngắn với năm trường, và signal là trường mà EA của bạn cần.

Trường	Kiểu	Nội dung
pair	string	Cặp tiền mục tiêu
score	integer (0-100)	Ước tính hướng đi của AI: gần 0 là bán, gần 100 là mua, 50 là trung lập
signal	string	Một trong BUY, SELL hoặc WAIT
action_en	string	Kế hoạch tóm tắt trong vài từ
timestamp	string (UTC)	Thời điểm của lần phân tích gần nhất

Ví dụ, một phản hồi cho vàng trông như sau:

{"pair":"XAU/USD","score":47,"signal":"WAIT","action_en":"Stay flat before US payrolls","timestamp":"2026-11-06T05:00:42Z"}

action_en chính là kế hoạch mà NinjaBull hiển thị bằng chữ lớn. Hãy ghi kế hoạch này vào log của EA, để sau này bạn có thể xem vì sao EA đã giao dịch hay chờ.

Vì sao điểm trung lập mà tín hiệu lại là SELL?

signal đọc câu chữ của kế hoạch trước, rồi mới đến điểm số. Ví dụ, ngày 6/11, Bitcoin có điểm số 44, mức mà NinjaBull hiển thị là NEUTRAL, nhưng kế hoạch là “Sell rallies in BTC/USD”, nên tín hiệu là SELL. API kiểm tra các quy tắc theo thứ tự và dừng ở quy tắc đầu tiên khớp.

1. Nếu kế hoạch chứa WAIT hoặc STANDBY, hoặc điểm số đúng bằng 50, tín hiệu là WAIT.
2. Nếu kế hoạch chứa BUY hoặc LONG, hoặc điểm số từ 60 trở lên, tín hiệu là BUY.
3. Nếu kế hoạch chứa SELL hoặc SHORT, hoặc điểm số từ 40 trở xuống, tín hiệu là SELL.
4. Trong mọi trường hợp còn lại, tín hiệu là WAIT. “Stay flat before US payrolls” ở mức 47 là một ví dụ.

Vì vậy, một SELL ở 44 và một SELL ở 30 là hai góc nhìn khác nhau, và chỉ score mới cho thấy sự khác biệt đó. Phần lớn điểm số nằm gần 50. Toàn bộ 114 lần phân tích trong đợt chạy thử của chúng tôi có điểm từ 40 đến 55, nên một ngưỡng như 30 sẽ chặn gần như mọi lệnh.

Tín hiệu NinjaBull cập nhật bao lâu một lần?

Tín hiệu cập nhật khi có chuyện xảy ra trên thị trường, không theo giờ cố định. Một lần phân tích mới bắt đầu sau dữ liệu kinh tế, một tin tức lớn hoặc một biến động giá mạnh, và cả khi các phiên Tokyo, London và New York mở cửa. Nếu 6 giờ không có cập nhật, một lần phân tích mới vẫn được chạy. Cách NinjaBull hoạt động liệt kê đầy đủ các trường hợp.

Trong đợt chạy thử của chúng tôi từ ngày 3 đến 6/11, vàng cập nhật khoảng 20 lần một ngày và Bitcoin khoảng 16 lần một ngày. Một nửa số khoảng cách giữa hai lần phân tích vàng là dưới 50 phút, và khoảng cách dài nhất là chưa đến 5 giờ.

Kiểm tra 5 phút một lần là đủ cho EA của bạn, vì cứ 5 phút NinjaBull lại tìm lý do để cập nhật. Hãy giữ khoảng thời gian này trong một thiết lập input.

// Recommended: keep it external
input int API_REFRESH_MINUTES = 5;  // NinjaBull looks for a reason to update every 5 minutes

Sau khi dữ liệu được công bố, tín hiệu mới đến sau 5 đến 20 phút. Vì vậy, trong những phút đầu sau công bố, EA của bạn vẫn đọc phân tích từ trước khi con số được đưa ra.

Trường timestamp cho bạn biết tín hiệu đã cũ bao lâu, nên hãy để EA kiểm tra timestamp trước khi EA hành động. Vào ngày trong tuần, một timestamp cũ hơn 7 giờ nghĩa là việc cập nhật đã dừng, vì API giữ kết quả cuối cùng khi một lần phân tích thất bại.

Vào cuối tuần, vàng giữ tín hiệu cuối cùng của thứ Sáu, nên EA của bạn có thể bỏ qua tín hiệu vàng cho đến thứ Hai. Bitcoin vẫn cập nhật vào cuối tuần, nhưng chỉ sau một biến động giá mạnh hoặc sau 6 giờ không có cập nhật.

Tín hiệu có về WAIT trước mỗi lần công bố không?

Tín hiệu vẫn có thể là BUY hoặc SELL vài phút trước một lần công bố, nên API không thay thế được lịch tin tức trong EA của bạn. AI thường viết kế hoạch như “Stay flat before US payrolls”, và kế hoạch đó cho WAIT. Tuy nhiên, API không có trường nào cho thời điểm công bố tiếp theo.

Nếu EA của bạn phải ngừng giao dịch quanh các đợt công bố lớn, hãy giữ quy tắc thời gian riêng của bạn cho các đợt đó và dùng tín hiệu làm bộ lọc hướng đi.

API dùng ngôn ngữ nào?

API NinjaBull dùng tiếng Anh. Trường action_en luôn bằng tiếng Anh, và các giá trị signal luôn là BUY, SELL hoặc WAIT.

Các lỗi của API NinjaBull có nghĩa là gì?

Lỗi 401 nghĩa là key sai, lỗi 404 nghĩa là pair sai, còn lỗi 500 là sự cố ở phía chúng tôi. Với lỗi 401 hoặc 404, thử lại cũng cho cùng lỗi đó, nên hãy để EA ngừng gọi API và kiểm tra lại yêu cầu.

401 Unauthorized

Nếu key sai hoặc thiếu, API trả về HTTP 401 kèm thông báo “Invalid or Missing API Key”.

404 Not Found

Nếu pair không phải XAU/USD hay BTC/USD, API trả về HTTP 404 kèm thông báo “State not found”. Một pair không có dấu gạch chéo, chẳng hạn XAUUSD, cũng trả về cùng lỗi đó.

500 Server Error

Nếu cơ sở dữ liệu của chúng tôi không phản hồi, API trả về HTTP 500 kèm thông báo “Database Connection Failed”. EA của bạn có thể thử lại ở lần kiểm tra 5 phút tiếp theo. Hãy quyết định trước EA sẽ làm gì khi API ngừng hoạt động, ví dụ không mở lệnh mới.

API NinjaBull có những giới hạn nào?

API đưa ra góc nhìn của AI về thị trường, nên EA của bạn vẫn cần quy tắc vào lệnh, stop loss và khối lượng lệnh của riêng mình. API không gửi giá vào lệnh, mức stop hay khối lượng lot.

score là ước tính của riêng AI, nên điểm số không phải tỷ lệ thắng đo được và không hứa hẹn kết quả nào. Một trang về kết quả trong quá khứ của NinjaBull đang được chuẩn bị.

API miễn phí cho EA và script của riêng bạn. Vui lòng không bán lại dữ liệu hay đăng dữ liệu lên trang web hoặc ứng dụng khác.

Bạn cần trang nào tiếp theo?

Mở NinjaBull để xem phân tích hiện tại trên một màn hình, hoặc đọc cách NinjaBull hoạt động trước khi đưa tín hiệu vào EA của bạn.