# vdemydiuk/mtapi architecture

> Architecture diagram of the GitHub repository vdemydiuk/mtapi, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vdemydiuk/mtapi
- Repository: https://github.com/vdemydiuk/mtapi

## Overview

MtApi is a .NET bridge for executing MetaTrader MQL operations through an Expert Advisor attached to a terminal chart; it is not a direct connection to MetaTrader servers. The principal workflow is an application invoking the MT4 or MT5 client API, which sends commands over WebSocket through the shared RPC client and service to the connector and chart-linked expert, then returns responses and trading events. README capabilities include local or remote TCP access and MT4/MT5 APIs. The available tree and excerpts establish only part of the native/MQL flow, so unshown links are omitted.

Main entry points: [`MtApi5/MtApi5Client.cs`](https://github.com/vdemydiuk/mtapi/blob/master/MtApi5/MtApi5Client.cs) (MT5 API), [`MtApi/MtApiClient.cs`](https://github.com/vdemydiuk/mtapi/blob/master/MtApi/MtApiClient.cs) (MT4 API), [`MtService/MtService.cpp`](https://github.com/vdemydiuk/mtapi/blob/master/MtService/MtService.cpp) (Service runtime), [`MTApiService/MtExecutorManager.cs`](https://github.com/vdemydiuk/mtapi/blob/master/MTApiService/MtExecutorManager.cs) (Command execution)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Client APIs"]
  node_api4["MT4 API<br/>[MtApiClient.cs]"]
  node_api5["MT5 API<br/>[MtApi5Client.cs]"]
end

subgraph group_transport["RPC and service"]
  node_commands["Command model<br/>[MtCommand.cs]"]
  node_rpc["WebSocket RPC<br/>[MtRpcClient.cs]"]
  node_serviceclient["Service client<br/>[MtClient.cs]"]
  node_service["Service runtime<br/>[MtService.cpp]"]
  node_servicecommand["Command execution"]
  node_response["Response types<br/>[MtResponse.cs]"]
end

subgraph group_terminal["Terminal bridge"]
  node_connector4["MT4 connector<br/>[MTConnector.cpp]"]
  node_connector5["MT5 connector<br/>[MT5Connector.cpp]"]
  node_expert4["MT4 expert handler<br/>[MT4Handler.h]"]
  node_expert5["MT5 expert handler<br/>[MT5Handler.h]"]
  node_terminalactor(("MetaTrader terminal"))
  node_mql["Chart-linked expert"]
end

subgraph group_domain["Trading capabilities"]
  node_trade["Trading operations<br/>[MtApi5Client.cs]"]
  node_market["Quotes and ticks<br/>[MtApi5Client.cs]"]
  node_history["History and series<br/>[MtApi5Client.cs]"]
  node_charts["Charts and objects<br/>[MtApiClient.cs]"]
  node_monitors["Trade monitors<br/>[TradeMonitor.cs]"]
end

node_user(("Application developer"))
node_testserver["Sample terminal model<br/>[MetaTrader.cs]"]

node_user -->|"calls API"| node_api4
node_user -->|"calls API"| node_api5
node_api4 -->|"sends commands"| node_rpc
node_api5 -->|"sends commands"| node_rpc
node_api4 -->|"exposes operations"| node_trade
node_api5 -->|"exposes operations"| node_trade
node_api5 -->|"exposes data"| node_market
node_api5 -->|"exposes history"| node_history
node_api4 -->|"exposes chart API"| node_charts
node_rpc -->|"exchanges RPC"| node_serviceclient
node_serviceclient -->|"submits commands"| node_servicecommand
node_servicecommand -->|"uses command"| node_commands
node_servicecommand -->|"returns result"| node_response
node_service -.->|"manages experts"| node_expert4
node_service -.->|"manages experts"| node_expert5
node_connector4 -.->|"bridges requests"| node_service
node_connector5 -.->|"bridges requests"| node_service
node_expert4 -.->|"invokes expert"| node_mql
node_expert5 -.->|"invokes expert"| node_mql
node_terminalactor -->|"hosts chart expert"| node_mql
node_mql -->|"executes MQL"| node_terminalactor
node_user -.->|"configures monitoring"| node_monitors
node_testserver -.->|"simulates commands"| node_trade

click node_api4 "https://github.com/vdemydiuk/mtapi/blob/master/MtApi/MtApiClient.cs"
click node_api5 "https://github.com/vdemydiuk/mtapi/blob/master/MtApi5/MtApi5Client.cs"
click node_commands "https://github.com/vdemydiuk/mtapi/blob/master/MTApiService/MtCommand.cs"
click node_rpc "https://github.com/vdemydiuk/mtapi/blob/master/MtClient/MtRpcClient.cs"
click node_serviceclient "https://github.com/vdemydiuk/mtapi/blob/master/MTApiService/MtClient.cs"
click node_service "https://github.com/vdemydiuk/mtapi/blob/master/MtService/MtService.cpp"
click node_servicecommand "https://github.com/vdemydiuk/mtapi/blob/master/MTApiService/MtExecutorManager.cs"
click node_response "https://github.com/vdemydiuk/mtapi/blob/master/MTApiService/MtResponse.cs"
click node_connector4 "https://github.com/vdemydiuk/mtapi/blob/master/MTConnector/MTConnector.cpp"
click node_connector5 "https://github.com/vdemydiuk/mtapi/blob/master/MT5Connector/MT5Connector.cpp"
click node_expert4 "https://github.com/vdemydiuk/mtapi/blob/master/MTConnector/MT4Handler.h"
click node_expert5 "https://github.com/vdemydiuk/mtapi/blob/master/MT5Connector/MT5Handler.h"
click node_trade "https://github.com/vdemydiuk/mtapi/blob/master/MtApi5/MtApi5Client.cs"
click node_market "https://github.com/vdemydiuk/mtapi/blob/master/MtApi5/MtApi5Client.cs"
click node_history "https://github.com/vdemydiuk/mtapi/blob/master/MtApi5/MtApi5Client.cs"
click node_charts "https://github.com/vdemydiuk/mtapi/blob/master/MtApi/MtApiClient.cs"
click node_monitors "https://github.com/vdemydiuk/mtapi/blob/master/MtApi/Monitors/TradeMonitor.cs"
click node_testserver "https://github.com/vdemydiuk/mtapi/blob/master/TestClients/TestServer/MetaTrader.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_api4,node_api5 toneBlue
class node_commands,node_rpc,node_serviceclient,node_service,node_servicecommand,node_response toneAmber
class node_connector4,node_connector5,node_expert4,node_expert5,node_terminalactor,node_mql toneMint
class node_trade,node_market,node_history,node_charts,node_monitors toneRose
class node_user,node_testserver toneIndigo
```

## Components

### Client APIs

- [MT4 API](https://github.com/vdemydiuk/mtapi/blob/master/MtApi/MtApiClient.cs): `MtApi/MtApiClient.cs`
- [MT5 API](https://github.com/vdemydiuk/mtapi/blob/master/MtApi5/MtApi5Client.cs): `MtApi5/MtApi5Client.cs`

### RPC and service

- [Command model](https://github.com/vdemydiuk/mtapi/blob/master/MTApiService/MtCommand.cs): `MTApiService/MtCommand.cs`
- [WebSocket RPC](https://github.com/vdemydiuk/mtapi/blob/master/MtClient/MtRpcClient.cs): `MtClient/MtRpcClient.cs`
- [Service client](https://github.com/vdemydiuk/mtapi/blob/master/MTApiService/MtClient.cs): `MTApiService/MtClient.cs`
- [Service runtime](https://github.com/vdemydiuk/mtapi/blob/master/MtService/MtService.cpp): `MtService/MtService.cpp`
- [Command execution](https://github.com/vdemydiuk/mtapi/blob/master/MTApiService/MtExecutorManager.cs): `MTApiService/MtExecutorManager.cs`
- [Response types](https://github.com/vdemydiuk/mtapi/blob/master/MTApiService/MtResponse.cs): `MTApiService/MtResponse.cs`

### Terminal bridge

- [MT4 connector](https://github.com/vdemydiuk/mtapi/blob/master/MTConnector/MTConnector.cpp): `MTConnector/MTConnector.cpp`
- [MT5 connector](https://github.com/vdemydiuk/mtapi/blob/master/MT5Connector/MT5Connector.cpp): `MT5Connector/MT5Connector.cpp`
- [MT4 expert handler](https://github.com/vdemydiuk/mtapi/blob/master/MTConnector/MT4Handler.h): `MTConnector/MT4Handler.h`
- [MT5 expert handler](https://github.com/vdemydiuk/mtapi/blob/master/MT5Connector/MT5Handler.h): `MT5Connector/MT5Handler.h`
- **MetaTrader terminal**
- **Chart-linked expert**

### Trading capabilities

- [Trading operations](https://github.com/vdemydiuk/mtapi/blob/master/MtApi5/MtApi5Client.cs): `MtApi5/MtApi5Client.cs`
- [Quotes and ticks](https://github.com/vdemydiuk/mtapi/blob/master/MtApi5/MtApi5Client.cs): `MtApi5/MtApi5Client.cs`
- [History and series](https://github.com/vdemydiuk/mtapi/blob/master/MtApi5/MtApi5Client.cs): `MtApi5/MtApi5Client.cs`
- [Charts and objects](https://github.com/vdemydiuk/mtapi/blob/master/MtApi/MtApiClient.cs): `MtApi/MtApiClient.cs`
- [Trade monitors](https://github.com/vdemydiuk/mtapi/blob/master/MtApi/Monitors/TradeMonitor.cs): `MtApi/Monitors/TradeMonitor.cs`

### Other components

- **Application developer**
- [Sample terminal model](https://github.com/vdemydiuk/mtapi/blob/master/TestClients/TestServer/MetaTrader.cs): `TestClients/TestServer/MetaTrader.cs`

## Connections

- Application developer → MT4 API: calls API
- Application developer → MT5 API: calls API
- MT4 API → WebSocket RPC: sends commands (evidence: `MtApi/MtApiClient.cs`)
- MT5 API → WebSocket RPC: sends commands (evidence: `MtApi5/MtApi5Client.cs`)
- MT4 API → Trading operations: exposes operations (evidence: `MtApi/MtApiClient.cs`)
- MT5 API → Trading operations: exposes operations (evidence: `MtApi5/MtApi5Client.cs`)
- MT5 API → Quotes and ticks: exposes data (evidence: `MtApi5/MtApi5Client.cs`)
- MT5 API → History and series: exposes history (evidence: `MtApi5/MtApi5Client.cs`)
- MT4 API → Charts and objects: exposes chart API (evidence: `MtApi/MtApiClient.cs`)
- WebSocket RPC → Service client: exchanges RPC (evidence: `MtClient/MtRpcClient.cs`)
- Service client → Command execution: submits commands (evidence: `MTApiService/MtClient.cs`)
- Command execution → Command model: uses command (evidence: `MTApiService/MtExecutorManager.cs`)
- Command execution → Response types: returns result
- Service runtime → MT4 expert handler: manages experts
- Service runtime → MT5 expert handler: manages experts
- MT4 connector → Service runtime: bridges requests
- MT5 connector → Service runtime: bridges requests
- MT4 expert handler → Chart-linked expert: invokes expert
- MT5 expert handler → Chart-linked expert: invokes expert
- MetaTrader terminal → Chart-linked expert: hosts chart expert
- Chart-linked expert → MetaTrader terminal: executes MQL
- Application developer → Trade monitors: configures monitoring
- Sample terminal model → Trading operations: simulates commands (evidence: `MtApi5/MtApi5Client.cs`)
