ASTRA AI
INSTALLATION AND USER GUIDE FOR METATRADER 4 AND METATRADER 5
ИНСТРУКЦИЯ ПО УСТАНОВКЕ И ИСПОЛЬЗОВАНИЮ В METATRADER 4 И METATRADER 5

======================================================================
ENGLISH
======================================================================

1. WHAT YOU NEED

- MetaTrader 4 or MetaTrader 5 desktop terminal.
- A trading account connected to the terminal. Start on a demo account.
- An API key from one of the supported AI providers if you want to use online AI analysis.
- A stable internet connection.

The AI provider is a separate service. Its subscription, request fees and usage limits are not included with Astra AI and depend on the selected provider.


2. INSTALLATION IN METATRADER 5

Installation from MQL5 Market:

1) Open MetaTrader 5 and sign in to your MQL5.community account.
2) Open Market / My Purchases in the terminal.
3) Find Astra AI and click Install.
4) Open the Navigator window (Ctrl+N), then open Expert Advisors.
5) Drag Astra AI onto the chart of the instrument you want to analyze.

Manual installation:

1) In MetaTrader 5, select File > Open Data Folder.
2) Open MQL5 > Experts.
3) Copy the Astra AI .ex5 file into this folder. If you received a source .mq5 file, copy it there, open it in MetaEditor and compile it with F7.
4) Return to MetaTrader 5, right-click Expert Advisors in Navigator and select Refresh. Restart the terminal if Astra AI does not appear.
5) Drag Astra AI onto a chart.


3. INSTALLATION IN METATRADER 4

Installation from MQL5 Market:

1) Open MetaTrader 4 and sign in to your MQL5.community account.
2) Open Market / My Purchases in the terminal.
3) Find Astra AI and click Install.
4) Open the Navigator window (Ctrl+N), then open Expert Advisors.
5) Drag Astra AI onto the chart of the instrument you want to analyze.

Manual installation:

1) In MetaTrader 4, select File > Open Data Folder.
2) Open MQL4 > Experts.
3) Copy the Astra AI .ex4 file into this folder. If you received a source .mq4 file, copy it there, open it in MetaEditor and compile it with F7.
4) Return to MetaTrader 4, right-click Expert Advisors in Navigator and select Refresh. Restart the terminal if Astra AI does not appear.
5) Drag Astra AI onto a chart.


4. ALLOW ALGORITHMIC TRADING

1) When attaching Astra AI to a chart, open the Common tab and allow algorithmic/live trading.
2) Enable the Algo Trading button in MetaTrader 5 or the AutoTrading button in MetaTrader 4.
3) Only one Expert Advisor can run on one chart. To use Astra AI on several instruments, open a separate chart for each instrument.


5. CONNECT AN AI PROVIDER

1) Open the Astra AI Inputs tab.
2) Set InpAIEnabled = true.
3) Select the required provider in InpAIProvider.
4) Paste your API key into InpAIApiKey.
5) Leave InpAIModel empty to let Astra AI select an available model automatically. If automatic selection fails, enter a valid model ID supplied by your provider.
6) Click OK and wait for the panel status to change to READY.

Never publish your API key, send it to other people, or include it in screenshots and shared preset files. MetaTrader may save input values in terminal settings or preset files.


6. ALLOW WEBREQUEST

In MetaTrader, open Tools > Options > Expert Advisors, enable “Allow WebRequest for listed URL” and add the address of the selected provider:

OpenAI: https://api.openai.com
Gemini: https://generativelanguage.googleapis.com
Grok: https://api.x.ai
Anthropic: https://api.anthropic.com
DeepSeek: https://api.deepseek.com
OpenRouter: https://openrouter.ai

For a Custom provider, add the base website address used by your endpoint, including https:// but normally without the final API path. Example: for https://example.com/v1 add https://example.com.

If you change the provider, add its address to the allowed list before using it. Reattach Astra AI to the chart or restart the terminal if required.


7. FIRST CONNECTION TEST

1) Confirm that the panel shows READY and KEY OK.
2) Click ANALYZE.
3) Wait for the AI response. A valid decision can contain BUY, SELL or HOLD, confidence, reference entry, Stop Loss, Take Profit, risk and a short explanation.
4) If the result is HOLD, Astra AI will not open a trade.


8. PANEL CONTROLS

ANALYZE — sends the current multi-timeframe market context to the selected AI and requests a structured trading decision.

POSITION — analyzes positions belonging to Astra AI on the current symbol and requests a management decision.

NEWS — requests a news summary using the economic calendar and/or the configured news source available in your terminal edition.

ASK — sends the question entered in the assistant field. Examples: “What is the current market trend?”, “What risks do you see before opening a trade?”, “Explain the current open position and possible scenarios.”

APPLY — manually executes the current valid AI decision after all local safety checks. It does nothing for HOLD, an expired decision or a decision that fails a safety check.

Auto analysis — periodically requests a new market analysis.

Auto entry — allows Astra AI to execute valid BUY or SELL decisions automatically when automation is armed.

Auto manage — allows automatic management decisions for positions belonging to Astra AI. Automatic modification or closing also depends on the corresponding safety permissions.

ARM AUTO — enables automatic actions for the current terminal session. Click ARM AUTO, then click CONFIRM AUTO within 7 seconds. The armed state is not restored automatically after the EA or terminal restarts.

DISARM AUTO — immediately disables automatic actions.

RESET GUARD — clears the temporary provider wait state and consecutive-error guard after the connection problem has been corrected. Daily request and token counters are preserved.

CLEAR — clears the latest decision and output from the panel.

< and > — switch the panel to the previous or next available symbol.


9. MANUAL USE

1) Open the required symbol chart.
2) Click ANALYZE.
3) Read the action, confidence, entry, SL, TP, explanation and risks.
4) Check that the displayed prices and risk are acceptable to you.
5) Click APPLY only if you want to execute the current decision.

APPLY is still protected by local checks, including algorithmic-trading permission, minimum confidence, decision age, spread, entry-price drift, valid SL/TP, position limit, daily trade limit, loss guard, cooldown, news guard and risk-based volume calculation. A blocked action is shown in the SYSTEM area.


10. AUTOMATIC USE

1) Enable Auto analysis and Auto entry on the panel. Enable Auto manage only if you also want Astra AI to manage its positions.
2) Click ARM AUTO.
3) Click CONFIRM AUTO within 7 seconds.
4) Keep MetaTrader running and connected to the broker and the internet.

On a real account, automatic actions remain blocked unless live automatic AI trading is explicitly permitted in the EA inputs. Always test the same configuration on a demo account first.

Astra AI does not have to open a trade after every analysis. It can return HOLD, wait for sufficient confidence, or block execution when a safety condition is not met.


11. STRATEGY TESTER AND OFFLINE MODE

MetaTrader does not allow WebRequest calls in the Strategy Tester, so online AI requests cannot run there. In the tester, Astra AI uses its local EMA/RSI/ATR fallback strategy when Offline Fallback is enabled. The local strategy calculates a direction, SL, TP and risk-based volume without sending data to an AI provider.

Offline trading on a live chart is disabled by default and should only be enabled deliberately. It is a local indicator strategy, not an AI response.


12. TROUBLESHOOTING

WebRequest blocked / HTTP 1003 / error -1:
Add the correct provider address under Tools > Options > Expert Advisors > Allow WebRequest for listed URL, then reattach the EA.

HTTP 401 or 403:
Check the API key, provider selection, account permissions and access to the selected model.

HTTP 400 or 404:
The model ID, endpoint or API format may be incorrect. Leave InpAIModel empty for automatic selection or enter a valid model ID. For a Custom provider, verify the endpoint and whether it uses Chat Completions or the Responses API.

HTTP 429 / quota or rate limit reached:
The provider has limited requests, tokens or billing quota. Wait for the displayed retry time, check the provider account and billing, then press RESET GUARD if necessary.

Provider temporarily unavailable / HTTP 5xx:
Wait and try again. This is normally a provider or gateway problem.

READY is not displayed:
Check InpAIEnabled, the provider, API key, internet connection and WebRequest permission.

Analysis works but no trade opens:
Check Algo Trading/AutoTrading, the decision action, confidence, APPLY or ARM AUTO state, Auto entry, live-account permission, spread, SL/TP validity, trading limits, cooldown, news guard and broker trading permissions.

Panel does not appear correctly:
Increase the chart size, use a standard chart scale, remove another EA from the same chart and reattach Astra AI.


13. IMPORTANT RISK NOTICE

Astra AI is a trading tool and cannot guarantee the accuracy of AI responses, order execution or future results. AI output may be incomplete, delayed or incorrect. Historical and tester results do not guarantee future performance. Trading leveraged products can result in the partial or complete loss of deposited funds. The user is solely responsible for provider costs, settings, decisions, trades and risk. Use a demo account first and trade only with funds you can afford to lose.


======================================================================
РУССКИЙ
======================================================================

1. ЧТО ПОТРЕБУЕТСЯ

- Настольный терминал MetaTrader 4 или MetaTrader 5.
- Торговый счёт, подключённый к терминалу. Начинайте проверку на демо-счёте.
- API-ключ одного из поддерживаемых ИИ-провайдеров для онлайн-анализа.
- Стабильное подключение к интернету.

ИИ-провайдер является отдельным сервисом. Его подписка, стоимость запросов и лимиты использования не входят в стоимость Astra AI и зависят от выбранного провайдера.


2. УСТАНОВКА В METATRADER 5

Установка из MQL5 Market:

1) Откройте MetaTrader 5 и войдите в свою учётную запись MQL5.community.
2) Откройте в терминале раздел Market / Мои покупки.
3) Найдите Astra AI и нажмите Установить.
4) Откройте окно Навигатор (Ctrl+N), затем раздел Советники.
5) Перетащите Astra AI на график инструмента, который хотите анализировать.

Ручная установка:

1) В MetaTrader 5 выберите Файл > Открыть каталог данных.
2) Откройте папку MQL5 > Experts.
3) Скопируйте в неё файл Astra AI с расширением .ex5. Если вы получили исходный файл .mq5, скопируйте его туда, откройте в MetaEditor и скомпилируйте клавишей F7.
4) Вернитесь в MetaTrader 5, нажмите правой кнопкой мыши на разделе Советники в Навигаторе и выберите Обновить. Если Astra AI не появился, перезапустите терминал.
5) Перетащите Astra AI на график.


3. УСТАНОВКА В METATRADER 4

Установка из MQL5 Market:

1) Откройте MetaTrader 4 и войдите в свою учётную запись MQL5.community.
2) Откройте в терминале раздел Market / Мои покупки.
3) Найдите Astra AI и нажмите Установить.
4) Откройте окно Навигатор (Ctrl+N), затем раздел Советники.
5) Перетащите Astra AI на график инструмента, который хотите анализировать.

Ручная установка:

1) В MetaTrader 4 выберите Файл > Открыть каталог данных.
2) Откройте папку MQL4 > Experts.
3) Скопируйте в неё файл Astra AI с расширением .ex4. Если вы получили исходный файл .mq4, скопируйте его туда, откройте в MetaEditor и скомпилируйте клавишей F7.
4) Вернитесь в MetaTrader 4, нажмите правой кнопкой мыши на разделе Советники в Навигаторе и выберите Обновить. Если Astra AI не появился, перезапустите терминал.
5) Перетащите Astra AI на график.


4. РАЗРЕШЕНИЕ АЛГОРИТМИЧЕСКОЙ ТОРГОВЛИ

1) При установке Astra AI на график откройте вкладку Общие и разрешите алгоритмическую/автоматическую торговлю.
2) Включите кнопку Algo Trading в MetaTrader 5 или AutoTrading в MetaTrader 4.
3) На одном графике может работать только один советник. Для работы Astra AI на нескольких инструментах откройте отдельный график для каждого инструмента.


5. ПОДКЛЮЧЕНИЕ ИИ-ПРОВАЙДЕРА

1) Откройте вкладку Входные параметры советника Astra AI.
2) Установите InpAIEnabled = true.
3) Выберите нужного провайдера в InpAIProvider.
4) Вставьте API-ключ в InpAIApiKey.
5) Оставьте InpAIModel пустым, чтобы Astra AI автоматически выбрал доступную модель. Если автоматический выбор не сработал, укажите действительный идентификатор модели вашего провайдера.
6) Нажмите OK и дождитесь появления статуса READY на панели.

Никогда не публикуйте API-ключ, не передавайте его другим людям и не показывайте на скриншотах или в общедоступных файлах настроек. MetaTrader может сохранять значения входных параметров в настройках терминала или preset-файлах.


6. РАЗРЕШЕНИЕ WEBREQUEST

В MetaTrader откройте Сервис > Настройки > Советники, включите «Разрешить WebRequest для следующих URL» и добавьте адрес выбранного провайдера:

OpenAI: https://api.openai.com
Gemini: https://generativelanguage.googleapis.com
Grok: https://api.x.ai
Anthropic: https://api.anthropic.com
DeepSeek: https://api.deepseek.com
OpenRouter: https://openrouter.ai

Для Custom-провайдера добавьте базовый адрес сайта, используемый вашим endpoint: обязательно с https://, но обычно без конечного пути API. Пример: для https://example.com/v1 добавьте https://example.com.

При смене провайдера сначала добавьте его адрес в список разрешённых. При необходимости повторно установите Astra AI на график или перезапустите терминал.


7. ПЕРВАЯ ПРОВЕРКА ПОДКЛЮЧЕНИЯ

1) Убедитесь, что на панели отображаются READY и KEY OK.
2) Нажмите ANALYZE.
3) Дождитесь ответа ИИ. Корректное решение может содержать BUY, SELL или HOLD, уверенность, ориентировочную цену входа, Stop Loss, Take Profit, риск и краткое объяснение.
4) Если результат — HOLD, Astra AI не откроет сделку.


8. КНОПКИ И ЭЛЕМЕНТЫ ПАНЕЛИ

ANALYZE — отправляет выбранному ИИ текущий рыночный контекст с нескольких таймфреймов и запрашивает структурированное торговое решение.

POSITION — анализирует позиции Astra AI по текущему символу и запрашивает решение по управлению ими.

NEWS — запрашивает сводку новостей на основе экономического календаря и/или настроенного источника новостей, доступного в вашей версии терминала.

ASK — отправляет вопрос из поля ассистента. Примеры: «Какой сейчас рыночный тренд?», «Какие риски вы видите перед открытием сделки?», «Объясни текущую открытую позицию и возможные сценарии».

APPLY — вручную исполняет текущее действительное решение ИИ после всех локальных проверок безопасности. Кнопка ничего не исполнит при HOLD, устаревшем решении или непройденной проверке.

Auto analysis — периодически запрашивает новый анализ рынка.

Auto entry — разрешает Astra AI автоматически исполнять действительные решения BUY или SELL после активации автоматического режима.

Auto manage — разрешает автоматические решения по управлению позициями Astra AI. Автоматическое изменение или закрытие также зависит от соответствующих разрешений безопасности.

ARM AUTO — активирует автоматические действия на текущую сессию терминала. Нажмите ARM AUTO, затем в течение 7 секунд нажмите CONFIRM AUTO. После перезапуска советника или терминала режим не включается автоматически.

DISARM AUTO — немедленно отключает автоматические действия.

RESET GUARD — сбрасывает временное ожидание провайдера и защиту от последовательных ошибок после устранения проблемы подключения. Суточные счётчики запросов и токенов сохраняются.

CLEAR — очищает последнее решение и вывод на панели.

< и > — переключают панель на предыдущий или следующий доступный символ.


9. РУЧНОЕ ИСПОЛЬЗОВАНИЕ

1) Откройте график нужного инструмента.
2) Нажмите ANALYZE.
3) Изучите действие, уверенность, точку входа, SL, TP, объяснение и риски.
4) Убедитесь, что указанные цены и риск для вас приемлемы.
5) Нажмите APPLY, только если хотите исполнить текущее решение.

Даже при ручном нажатии APPLY действуют локальные проверки: разрешение алгоритмической торговли, минимальная уверенность, срок действия решения, спред, отклонение цены от рассчитанной точки входа, корректность SL/TP, лимит позиций и сделок за день, ограничение дневного убытка, пауза между сделками, новостной фильтр и расчёт объёма по риску. Причина блокировки отображается в области SYSTEM.


10. АВТОМАТИЧЕСКОЕ ИСПОЛЬЗОВАНИЕ

1) Включите на панели Auto analysis и Auto entry. Включайте Auto manage только в том случае, если хотите, чтобы Astra AI управлял своими позициями.
2) Нажмите ARM AUTO.
3) В течение 7 секунд нажмите CONFIRM AUTO.
4) Не закрывайте MetaTrader и поддерживайте подключение к брокеру и интернету.

На реальном счёте автоматические действия остаются заблокированными, пока автоматическая торговля ИИ на реальном счёте явно не разрешена во входных параметрах. Сначала обязательно проверьте ту же конфигурацию на демо-счёте.

Astra AI не обязан открывать сделку после каждого анализа. Он может выдать HOLD, ждать достаточной уверенности или заблокировать исполнение при нарушении условий безопасности.


11. ТЕСТЕР СТРАТЕГИЙ И ОФЛАЙН-РЕЖИМ

MetaTrader не разрешает вызовы WebRequest в Тестере стратегий, поэтому онлайн-запросы к ИИ там не выполняются. Если включён Offline Fallback, в тестере Astra AI использует локальную стратегию EMA/RSI/ATR. Она без отправки данных ИИ-провайдеру рассчитывает направление, SL, TP и объём позиции с учётом риска.

Офлайн-торговля на обычном графике по умолчанию отключена и должна включаться только осознанно. Это локальная индикаторная стратегия, а не ответ ИИ.


12. УСТРАНЕНИЕ ОШИБОК

WebRequest blocked / HTTP 1003 / ошибка -1:
Добавьте правильный адрес провайдера в Сервис > Настройки > Советники > Разрешить WebRequest для следующих URL, затем повторно установите советник на график.

HTTP 401 или 403:
Проверьте API-ключ, выбранного провайдера, разрешения аккаунта и доступ к указанной модели.

HTTP 400 или 404:
Возможно, неверно указаны модель, endpoint или формат API. Оставьте InpAIModel пустым для автоматического выбора либо укажите действительный идентификатор модели. Для Custom-провайдера проверьте endpoint и выбор Chat Completions или Responses API.

HTTP 429 / исчерпан лимит или квота:
Провайдер ограничил количество запросов, токенов или платёжную квоту. Дождитесь указанного времени повторной попытки, проверьте аккаунт и биллинг провайдера, затем при необходимости нажмите RESET GUARD.

Provider temporarily unavailable / HTTP 5xx:
Подождите и повторите попытку. Обычно это временная проблема провайдера или шлюза.

Не появляется статус READY:
Проверьте InpAIEnabled, выбранного провайдера, API-ключ, интернет и разрешение WebRequest.

Анализ работает, но сделка не открывается:
Проверьте Algo Trading/AutoTrading, действие в решении, уверенность, нажатие APPLY либо состояние ARM AUTO, Auto entry, разрешение для реального счёта, спред, корректность SL/TP, торговые лимиты, паузу между сделками, новостной фильтр и разрешение торговли у брокера.

Панель отображается неправильно:
Увеличьте размер графика, используйте стандартный масштаб, удалите другой советник с этого графика и повторно установите Astra AI.


13. ВАЖНОЕ ПРЕДУПРЕЖДЕНИЕ О РИСКАХ

Astra AI является торговым инструментом и не гарантирует точность ответов ИИ, исполнение ордеров или будущий результат. Ответ ИИ может быть неполным, запоздалым или ошибочным. Исторические результаты и результаты тестера не гарантируют будущую доходность. Торговля инструментами с кредитным плечом может привести к частичной или полной потере внесённых средств. Пользователь самостоятельно отвечает за оплату ИИ-провайдера, настройки, решения, сделки и риск. Сначала используйте демо-счёт и торгуйте только теми средствами, потерю которых можете себе позволить.


OFFICIAL METATRADER REFERENCES / ОФИЦИАЛЬНЫЕ СПРАВОЧНЫЕ МАТЕРИАЛЫ:

MT5 Expert Advisors:
https://www.metatrader5.com/en/terminal/help/algotrading/trade_robots_indicators

MT5 WebRequest:
https://www.mql5.com/en/docs/network/webrequest

MT4 Expert Advisors:
https://www.metatrader4.com/en/trading-platform/help/autotrading/experts/experts_launch

MT4 WebRequest:
https://docs.mql4.com/common/webrequest