Services

EA AccountStatusUpdaterAccountStatusUpdater EA

EA MQL5 gắn trên một chart của mỗi terminal MT5: gửi trạng thái tài khoản (balance, equity, lệnh mở, lịch sử, EA đang chạy) lên fxconsole qua HTTP hoặc TLS-TCP, stream lịch sử deal khi có yêu cầu báo cáo và vẽ panel thông tin. Trang này giúp bạn cấu hình input, chọn transport và đọc panel. An MQL5 EA attached to one chart per MT5 terminal: it sends account status (balance, equity, open positions, history, running EAs) to fxconsole over HTTP or TLS-TCP, streams deal history when a report is requested, and draws an info panel. This page helps you configure inputs, pick a transport and read the panel.

• Cập nhậtUpdated 26/09/2026
• Phiên bảnVersion 1.16
• NguồnSource monitor/ea-account-status-updater/AccountStatusUpdater.mq5 · monitor/AccountStatusBroker/broker.js · monitor/README.html

Tổng quanOverview

Lịch sử phiên bản gần đâyRecent version history

InputInputs

=== API ===

=== Node identity ===

=== Transport ===

=== Info Panel ===

Transport: HTTP / TCP_SOCKET / HYBRID

Payload HTTPHTTP payload

Stream báo cáo qua pending_reportReport streaming via pending_report

1. User bấm Generate trên /dashboard/accounts/{id}. Laravel lưu yêu cầu; response POST /api/account-status kế tiếp chứa "pending_report":{…,"from_ts":N,…,"to_ts":N}. Ở HYBRID, broker còn đẩy report_request ngay.A user clicks Generate on /dashboard/accounts/{id}. Laravel stores the request; the next POST /api/account-status response carries "pending_report":{…,"from_ts":N,…,"to_ts":N}. In HYBRID the broker also pushes report_request immediately.
2. EA thấy khoảng from/to mới → con trỏ = from, bật g_forceHttpNow. Cùng khoảng (đang stream dở) → giữ con trỏ. Response không còn pending_report → xoá trạng thái.The EA sees a new from/to range → cursor = from, sets g_forceHttpNow. Same range (mid-stream) → cursor kept. No pending_report in the response → state cleared.
3. Mỗi POST mang 1 chunk 7 ngày [cursor, min(cursor + 7d, to)): report_deals gồm deal đóng lệnh (type đảo từ loại deal thành hướng position gốc) và thao tác balance (type = "balance", symbol rỗng, comment của broker như "Deposit"). is_first khi chunk bắt đầu tại from; is_last khi chạm to.Each POST carries one 7-day chunk [cursor, min(cursor + 7d, to)): report_deals holds closing deals (type flipped from the deal type to the original position side) and balance operations (type = "balance", empty symbol, broker comment such as "Deposit"). is_first when the chunk starts at from; is_last when it reaches to.
4. POST thành công: chunk cuối → xoá trạng thái; chưa cuối → con trỏ = cuối chunk và bật lại g_forceHttpNow để chunk sau đi ở tick 1s kế tiếp (1.13).Successful POST: last chunk → state cleared; otherwise cursor = chunk end and g_forceHttpNow is re-armed so the next chunk leaves on the next 1s tick (1.13).
5. Server: is_first xoá deal cũ của tài khoản, is_last tính tổng kết và xoá yêu cầu. Thiếu hai cờ → coi như true/true (EA cũ gửi 1 lần). Giới hạn: report_deals ≤ 20000, today_history ≤ 2000 phần tử. Lỗi ingest không làm hỏng lần push trạng thái, được log vào kênh deployment.Server: is_first truncates the account's old deals, is_last computes the summary and clears the request. Missing flags → treated as true/true (older single-shot EAs). Limits: report_deals ≤ 20000, today_history ≤ 2000 items. Ingest errors don't fail the status push and are logged to the deployment channel.

Luồng TLS với AccountStatusBrokerTLS flow with AccountStatusBroker

Kết nối và HELLOConnect and HELLO

1. SocketCreate() → SocketConnect(InpBrokerHost, InpBrokerPort, 5000) → SocketTlsHandshake(host). Lỗi ở bước nào thì đóng handle, in lỗi và trả false.SocketCreate() → SocketConnect(InpBrokerHost, InpBrokerPort, 5000) → SocketTlsHandshake(host). Any failure closes the handle, prints the error and returns false.
2. Gửi HELLO|statuspub|v2|<composite_id>|<InpBrokerSecret>|<broker_name>. composite_id = slug(ACCOUNT_COMPANY)::slug(ACCOUNT_SERVER)::login (chữ thường, ký tự khác [a-z0-9] gộp thành một -, bỏ - đầu cuối; rỗng → unknown-company / unknown-server) — cùng quy tắc với regex của broker.Send HELLO|statuspub|v2|<composite_id>|<InpBrokerSecret>|<broker_name>. composite_id = slug(ACCOUNT_COMPANY)::slug(ACCOUNT_SERVER)::login (lowercase, any run of non-[a-z0-9] collapsed to one -, leading/trailing - trimmed; empty → unknown-company / unknown-server) — the same rule as the broker's regex.
3. Socket mới = trạng thái mới: g_streamOn = false, xoá buffer nhận. Broker trả stream_off hoặc stream_on ngay sau HELLO.Fresh socket = fresh state: g_streamOn = false, receive buffer cleared. The broker answers with stream_off or stream_on right after HELLO.

Frame nhận từ brokerFrames received from the broker

sequenceDiagram
  participant E as AccountStatusUpdater (HYBRID)
  participant B as AccountStatusBroker 9602
  participant L as fxconsole /api/account-status
  E->>B: SocketConnect 5s + TLS + HELLO statuspub v2
  B-->>E: stream_off hb_interval_secs=15
  loop Mỗi 15s (stream tắt)
    E->>B: t=hb
  end
  loop Mỗi 30s (InpHybridHttpIntervalSec)
    E->>L: POST payload đầy đủ
    L-->>E: ok (+ pending_report nếu có)
  end
  B-->>E: stream_on cadence_ms (có người mở dashboard)
  loop Mỗi tick, cách nhau ≥ InpMinPushIntervalMs
    E->>B: payload đầy đủ nếu có thay đổi
  end
  B-->>E: report_request from_ts to_ts
  E->>L: POST + report_deals chunk 7 ngày
  L-->>E: pending_report
  E->>L: chunk tiếp theo ở tick 1s kế tiếp ... is_last
  B-->>E: stream_off (người xem cuối rời đi)

sequenceDiagram
  participant E as AccountStatusUpdater (HYBRID)
  participant B as AccountStatusBroker 9602
  participant L as fxconsole /api/account-status
  E->>B: SocketConnect 5s + TLS + HELLO statuspub v2
  B-->>E: stream_off hb_interval_secs=15
  loop Every 15s (stream off)
    E->>B: t=hb
  end
  loop Every 30s (InpHybridHttpIntervalSec)
    E->>L: POST full payload
    L-->>E: ok (+ pending_report if any)
  end
  B-->>E: stream_on cadence_ms (someone opened a dashboard)
  loop Every tick, at least InpMinPushIntervalMs apart
    E->>B: full payload if changed
  end
  B-->>E: report_request from_ts to_ts
  E->>L: POST + report_deals 7-day chunk
  L-->>E: pending_report
  E->>L: next chunk on the next 1s tick ... is_last
  B-->>E: stream_off (last viewer left)

Info panelInfo panel

Hạn chế đã biếtKnown limitations

InpStatus running / suspend và file .setInpStatus running / suspend and the .set files

Cài đặt trong MT5MT5 setup

1. Tools → Options → Expert Advisors → Allow WebRequest for listed URL: thêm host của InpApiUrl và InpBrokerHost (SocketConnect dùng chung danh sách này).Tools → Options → Expert Advisors → Allow WebRequest for listed URL: add the host of InpApiUrl and InpBrokerHost (SocketConnect uses the same list).
2. Bật Allow DLL imports nếu muốn InpNode tự lấy tên máy.Enable Allow DLL imports if InpNode should default to the computer name.
3. Điền InpApiUrl, InpApiBearer, InpAccountSecretKey, chu kỳ POST/panel; với HYBRID thêm InpBrokerSecret. Quan hệ các loại key: fxconsole — Bearer token, secret key.Fill InpApiUrl, InpApiBearer, InpAccountSecretKey, POST/panel cadence; for HYBRID also InpBrokerSecret. How the keys relate: fxconsole — Bearer token, secret key.
4. Gắn EA vào một chart mỗi terminal. Kiểm tra log AccountStatusUpdater composite_id=… và AccountStatusUpdater OK 200, panel dòng API xanh.Attach the EA to one chart per terminal. Check the log for AccountStatusUpdater composite_id=… and AccountStatusUpdater OK 200, and a green API row on the panel.