--- id: document_item.mooncmd-protocol-description page_type: documentation_article title: "MoonCDM Protocol Description" description: "Technical description of the MoonCDM binary format, including little-endian data types, header structure, historical prices, orders, chart trades, delta and volume blocks." section: documentation category: "Additional materials / MoonCMD Remote Control Protocol" url: https://moonbot.eu/en/documentation/mooncmd-remote-control-protocol/mooncmd-protocol-description?format=md locale: en alternate_ru: https://moonbot.eu/documentation/mooncmd-remote-control-protocol/mooncmd-protocol-description?format=md parent: https://moonbot.eu/en/documentation/mooncmd-remote-control-protocol?format=md previous: https://moonbot.eu/en/documentation/mooncmd-remote-control-protocol/general-information-about-the-mooncmd-protocol?format=md next: https://moonbot.eu/en/documentation/mooncmd-remote-control-protocol/order-database?format=md status: published updated_at: 2026-10-16T18:23:44+03:00 --- # MoonCDM Protocol Description ### Basic Types Byte order: little-endian for all numeric types. Types: - word – 2 bytes (UInt16); - integer – 4 bytes (Int32); - single – 4 bytes (float); - boolean – 1 byte (0 = false, 1 = true); - TDateTime – 8 bytes (double), number of days since 30 December 1899:\ 0.0 = 30 December 1899 00:00\ 1.0 = 31 December 1899 00:00\ 0.5 = 30 December 1899 12:00, etc. **Short string (Delphi ShortString):** \- string\[40\] = 41 bytes:\ 1 byte for the length Len (0..40), followed by Len bytes of characters (ANSI / single-byte encoding). UTF-8 strings (WriteStringToStreamUtf8):\ \- 2 bytes: word L – the length of the string data in bytes\ \- L bytes: UTF-8 without BOM. ### Header Reading sequence: 1. Read the ‘ver’ word (2 bytes) – the format version. 2. Read 4 lines in UTF-8: 1. MarketName: - word L - L bytes of UTF-8; 2. MarketCurrency: - word L - L bytes UTF-8; 3. PumpChannel (cfg.PumpChannel): - word L- L bytes UTF-8; 4. bnMarketName: - word L- L bytes UTF-8. ### Time Interval Reading procedure: 1. Read StartTime (8-byte double, TDateTime); 2. Read EndTime (8-byte double, TDateTime). ### Historical Price Line (HistoryPrice) **THistoricalPrice** element (correction): Used in the stream as a pair (Time, Price), both of type double. Element type: - 8 bytes: double Time; - 4 bytes: single Price. **Reading order:** 1. Read an integer N (4 bytes) – the number of elements; 2. If N > 0, read N elements in sequence:\ for i = 0..N-1: 1. 8 bytes: Time\[i\]; 2. 8 bytes: Price\[i\]. ### pData ORDERS (if written) In the stream, this looks like this: **Reading order:** 1. Read integer N (4 bytes): 1. if pData = nil when written, then N = 0 (no further orders); 2. if pData ≠ nil, then N = 2 (exactly two orders). 2. If N > 0, read N = 2 times: Buy Order and Sell Order: 1. OrderID: TOrderUID = string\[40\]:\ \- 1 byte: Len (0..40)\ \- Len bytes: identifier data (single-byte characters) (if you wish to strictly replicate Delphi ShortString, you can always read 41 bytes, but for parsing, the following is sufficient: 1 byte for length + Len bytes of data) 2. MeanPrice:\ \- 8 bytes: double 3. CreateTime:\ \- 8 bytes: double (TDateTime) 4. OpenTime:\ \- 8 bytes: double (TDateTime) 5. CloseTime:\ \- 8 bytes: double (TDateTime). ### Trades on the Chart (crosses, OrdersH) THPackedHOrder element: - 8 bytes: double Time (TDateTime) - 4 bytes: single Price (for sell orders, the price is recorded with a ‘−’ sign). **Reading order:** 1. Read integer N (4 bytes) – the number of trades. 2. If N > 0, read N elements in sequence:\ for j = 0..N-1:\ \- 8 bytes: Time\[j\]\ \- 4 bytes: Price\[j\]. ### Delta/Volume Block (two variants) - Last1mDelta – 8 bytes - Last5mDelta – 8 bytes - Last1hDelta – 8 bytes - Last3hDelta – 8 bytes - Last24hDelta – 8 bytes - PumpDelta1h – 8 bytes - DumpDelta1h – 8 bytes - hvol – 8 bytes - hvolFast – 8 bytes - TestPriceDown – 8 bytes - TestPriceUp – 8 bytes - IsMoonShot – 1 byte - SessionProfit – 8 bytes. ### Average Price Line for Trades (ClosestPrices) Elements of the same format as the THistoricalPrice records above:\ (Time, Price), both double. Element type: - 8 bytes: double Time; - 8 bytes: double Price. **Reading order** 1. 1\) Read integer N (4 bytes) – the number of points. 2. 2\) If N > 0, read N elements in sequence:\ for k = 0..N-1:\ \- 8 bytes: Time\[k\]\ \- 8 bytes: Price\[k\]\ (In the code, N=0 is written first, then the elements themselves, then the code returns and rewrites N. \ What matters to the reader is the final form: the number and N elements). ### Mini Candles (SCandles) TMiniCandle structure: - 8 bytes: Time – TDateTime (double) - 4 bytes: Cnt – integer (Int32) - 8 bytes: MinPrice – double - 8 bytes: MaxPrice – double - 8 bytes: BuyVol – double - 8 bytes: SellVol – double. Size of a single TMiniCandle element = 44 bytes. **Reading order** 1. 1\) Read integer N (4 bytes) – the number of mini-candles. 2. 2\) If N > 0, for each candle (i = 0..N-1) read: 1. Time – 8 bytes (double, TDateTime); 2. Cnt – 4 bytes (integer); 3. MinPrice – 8 bytes (double); 4. MaxPrice – 8 bytes (double); 5. BuyVol – 8 bytes (double); 6. SellVol – 8 bytes (double). ### Final File Read Order 1. word ver; 2. UTF-8 string MarketName; 3. UTF-8 string MarketCurrency; 4. UTF-8 string PumpChannel; 5. UTF-8 string bnMarketName; 6. TDateTime StartTime (double); 7. TDateTime EndTime (double); 8. integer N_History; 9. N_History \* (Time, Price) as double,double; 10. integer N_Orders; 11. N_Orders \* (OrderID string\[40\], MeanPrice, CreateTime, OpenTime, CloseTime); 12. integer N_Trades; 13. N_Trades \* (Time, Price) as double,double; 14. Delta/Volume block; 15. double SessionProfit; 16. integer N_ClosestPrices; 17. N_ClosestPrices \* (Time, Price) as double,double; 18. integer N_SCandles; 19. N_SCandles \* TMiniCandle (Time, Cnt, MinPrice, MaxPrice, BuyVol, SellVol). ## Navigation Path: [Main](https://moonbot.eu/en?format=md) / [Documentation](https://moonbot.eu/en/documentation?format=md) / [Additional materials](https://moonbot.eu/en/documentation/additional-materials?format=md) / [MoonCMD Remote Control Protocol](https://moonbot.eu/en/documentation/mooncmd-remote-control-protocol?format=md) / MoonCDM Protocol Description Parent section: [MoonCMD Remote Control Protocol](https://moonbot.eu/en/documentation/mooncmd-remote-control-protocol?format=md) Previous: [General Information about the MoonCMD Protocol](https://moonbot.eu/en/documentation/mooncmd-remote-control-protocol/general-information-about-the-mooncmd-protocol?format=md) Next: [Order Database](https://moonbot.eu/en/documentation/mooncmd-remote-control-protocol/order-database?format=md) ## Related - [Order Database](https://moonbot.eu/en/documentation/mooncmd-remote-control-protocol/order-database?format=md) - [Structure of repositories](https://moonbot.eu/en/documentation/mooncmd-remote-control-protocol/structure-of-repositories?format=md)