MQL4 ERR_FUNCTION_NOT_ALLOWED

MQL4 error 4060: move the call to a valid context

MQL4 error 4060 function not allowed for call maps to ERR_FUNCTION_NOT_ALLOWED: function is not allowed for call. The operation is unavailable from the current MQL4 program type, handler, tester mode, or terminal context. Capture GetLastError immediately after the failed call, correct the cause, and retry only when the condition can change.

Open the Coding Agent, then choose MQL4 from the language menu.

ContextGuard.mq4.mq4
#property strict
#property script_show_inputs

input int Period = 14;

void OnStart()
  {
   if(Period < 1 || Bars <= Period)
     {
      Print("Invalid period or insufficient history: ", Period);
      return;
     }

   ResetLastError();
   double value = iMA(NULL, 0, Period, 0, MODE_SMA, PRICE_CLOSE, 1);
   int error_code = GetLastError();
   if(error_code != 0)
     {
      Print("iMA failed. error=", error_code);
      return;
     }

   Print("SMA: ", DoubleToString(value, Digits));
  }
  • Official meaning: function is not allowed for call
  • Read the failed API return value first
  • Capture GetLastError immediately
  • Retry only when the condition can change

What MQL4 error 4060 means

The official MQL4 runtime table names error 4060 ERR_FUNCTION_NOT_ALLOWED and defines it as “function is not allowed for call.” The operation is unavailable from the current MQL4 program type, handler, tester mode, or terminal context.

The error number is evidence about one failed call, not a diagnosis of the whole EA. Read the API sentinel first, then call GetLastError immediately because that function returns the current _LastError value and resets it.

Check these conditions before editing the strategy

Start with the inputs and external state that existed at the failure point. A later log entry or a successful call can overwrite the useful context.

  • The API is called from an unsupported program type or event handler
  • A synchronous operation is attempted from a restricted runtime context
  • Strategy Tester does not support the same operation as a live chart
  • Shared helper code ignores whether it runs in an EA, indicator, or script

Fix the cause, then choose a retry policy

Do not retry in the same prohibited context. The program type, handler, or environment must change.

Keep the original trading and risk rules intact. A workaround that widens stops, increases volume, changes an account setting, or ignores a failed return value can hide the symptom while changing the system.

CheckAction
The API is called from an unsupported program type or event handlerRead the API restrictions and identify the permitted program context.
A synchronous operation is attempted from a restricted runtime contextMove the operation to a supported handler or a separate program.
Strategy Tester does not support the same operation as a live chartAdd an explicit tester or runtime branch when behavior differs.
Shared helper code ignores whether it runs in an EA, indicator, or scriptKeep context-dependent calls out of helpers that cannot verify their caller.

Review the complete example

The script keeps its operation inside OnStart and validates inputs before the call. Replace the sample with the failing API and move it to a context documented to support that function.

The example improves validation and logging. It does not prove the operation will be accepted by a broker or behave safely in live trading.

ContextGuard.mq4.mq4
#property strict
#property script_show_inputs

input int Period = 14;

void OnStart()
  {
   if(Period < 1 || Bars <= Period)
     {
      Print("Invalid period or insufficient history: ", Period);
      return;
     }

   ResetLastError();
   double value = iMA(NULL, 0, Period, 0, MODE_SMA, PRICE_CLOSE, 1);
   int error_code = GetLastError();
   if(error_code != 0)
     {
      Print("iMA failed. error=", error_code);
      return;
     }

   Print("SMA: ", DoubleToString(value, Digits));
  }
Where Pineify fits

Move from the rule to editable MQL4 source

Pineify can generate or revise one self-contained .mq4 file with MQL4-specific reference context. Its independent static checker returns MetaEditor diagnostics so you can repair source issues before testing in your own MT4 environment.

Open MQL4 Coding Agent

Static diagnostics do not prove runtime behavior, backtest results, broker compatibility, or live-trading safety.

Pineify MQL4 Coding Agent with MQL4 selected and an editable MetaTrader 4 code artifact

A practical workflow

  1. 1

    Confirm the failed call

    Check the API return value before interpreting an error number from the log.

  2. 2

    Capture the error once

    Call GetLastError immediately and record error 4060, symbol, prices, volume, ticket, and terminal state relevant to the operation.

  3. 3

    Correct the triggering condition

    Read the API restrictions and identify the permitted program context.

  4. 4

    Retest in the target environment

    Compile the revised source, then test with the same MT4 build, broker, symbol, account permissions, and market state.

Frequently asked questions

What does MQL4 error 4060 function not allowed for call mean?

ERR_FUNCTION_NOT_ALLOWED means function is not allowed for call. The code should still identify which API returned failure and log the inputs used for that call.

What usually causes MQL4 error 4060?

The API is called from an unsupported program type or event handler A synchronous operation is attempted from a restricted runtime context Strategy Tester does not support the same operation as a live chart Shared helper code ignores whether it runs in an EA, indicator, or script

Should an EA retry after error 4060?

Do not retry in the same prohibited context. The program type, handler, or environment must change.

Why should GetLastError be called immediately?

It reports the current _LastError value and resets it. Other operations can change the error state, so a delayed read may describe the wrong call.

Can Pineify fix MQL4 error 4060?

Pineify can revise a self-contained .mq4 file, add validation and error logging, and return static MetaEditor diagnostics. It cannot prove broker acceptance, account permissions, market availability, or live execution.

Last verified against the linked official references on . Compile and test the final source in the MetaTrader 4 build, broker, symbol, and account environment you plan to use.

Continue with one reviewable MQL4 file

Define the requirement, inspect the generated source, repair diagnostics, and test the behavior in your own MT4 environment.

Open Coding Agent