Natural Language Processing NLP

Natural Language Processing NLP

? Overview

AlgoNLP.mqh is a standalone MQL5 library that converts human-written trading instructions into structured trade intents that your Expert Advisor (EA) or indicator can understand.

Example input:

Output intent:

This enables you to build chat-controlled or Telegram-integrated EAs that can interpret plain English commands and execute structured trades.

➡️ Check my Articles for deatiled explaintion on how NLP works and implement it using mq5.

⚙️ System Requirements

➡️ benchmarks may vary in real environments.

? Library Structure

➡️ View in-depth architecture diagram:

? Core Data Types

SNLPIntent — Parsed Trade Object

? How It Works

1. Normalization: Text is lowercased, cleaned, and synonyms replaced (take profit → tp).
2. Tokenization: Words are split and stopwords filtered out.
3. Lexical Matching: Detects intent direction using fuzzy Levenshtein distance ≤1.
4. Number Context Extraction: Interprets numbers as price, TP/SL, or lot size via unit analysis.
5. Timing Logic: Recognizes “at 09:15”, “in 15 min”, and breakout triggers.
6. Symbol Resolution: Infers instruments like gold → XAUUSD.
7. Intent Build: Constructs SNLPIntent and triggers listener callbacks.

? Example Integration

#include <AlgoNLP.mqh>

class CMyListener : public INLPListener
{
 public:
  void OnOrderIntent(const SNLPIntent &i) override
  {
     Print("✅ NLP Worked!");
     Print("Side: ", EnumToString(i.side));
     Print("Type: ", EnumToString(i.type));
     Print("Symbol: ", i.symbol);
     Print("TP: ", DoubleToString(i.tp, 2), " | SL: ", DoubleToString(i.sl, 2));
  }
};

CMyListener listener;
CNLP nlp;

int OnInit()
{
   nlp.AddSymbol("XAUUSDm");
   nlp.AddListener(listener);
   return(INIT_SUCCEEDED);
}

void OnStart()
{
   string text="Buy gold at 2370 with TP 0.3% and SL 1%";
   nlp.Dispatch(text);
}

? Performance Metrics

➡️ Benchmark performed on Intel i7-9700 / MT5 Build 3820.

? Summary

AlgoNLP.mqh transforms ordinary text into actionable trade logic inside MetaTrader. It’s designed for developers who want their EAs to think like humans — understanding plain English instructions and executing trades intelligently. This isn’t a shortcut — it’s a full linguistic computation system written in native MQL5.