MT5 error 10012: Request canceled by timeout (TRADE_RETCODE_TIMEOUT)

What it means

You see this code in the retcode of a trade result, from OrderSend() in MQL5 or order_send() in Python.

10012 means the request was given up on because no answer arrived in time. The time limit expired on the terminal side, not necessarily on the broker's.

A timeout doesn't prove the broker did nothing. The request may have reached the server and been filled after the terminal stopped waiting.

Common causes

• A slow or overloaded trade server.
• A poor network path between the terminal and the broker.
• A request sent during a reconnect.

How to fix it

• Check positions, orders and deals for your request before doing anything else.
• Check the terminal's connection and ping to the server.
• If timeouts are frequent, move the terminal closer to the broker's servers.

Example in Python:

import MetaTrader5 as mt5
from datetime import datetime, timedelta

TAG = "job-4711"          # your own id for this order, also sent as the comment
MAGIC = 4711

def find_my_order(symbol):
    """Look for the effect of an order whose answer was unclear."""
    for p in mt5.positions_get(symbol=symbol) or ():
        if p.magic == MAGIC and p.comment == TAG:
            return "position", p.ticket
    for o in mt5.orders_get(symbol=symbol) or ():
        if o.magic == MAGIC and o.comment == TAG:
            return "pending order", o.ticket
    # Server time is not UTC, so search a wide window.
    now = datetime.now()
    deals = mt5.history_deals_get(now - timedelta(days=1), now + timedelta(days=1)) or ()
    for d in deals:
        if d.magic == MAGIC and d.comment == TAG:
            return "deal", d.ticket
    return None, None

r = mt5.order_send(request)
if r is not None and r.retcode == mt5.TRADE_RETCODE_TIMEOUT:
    kind, ticket = find_my_order(request["symbol"])
    print("found" if kind else "nothing found yet", kind, ticket)

Is it safe to retry?

Only after you have confirmed that the first request left no trace.

Could the order have executed?

How Tickwire handles it

Tickwire treats 10012 like a lost connection. It doesn't resend; it looks for the result and reports applied, rejected or unknown. See idempotency.

MT4 error 128 (trade timeout) gets the same care.

Related codes

• MT5 error 10031: No connection with the trade server (TRADE_RETCODE_CONNECTION)
• MT5 error 10011: Request processing error (TRADE_RETCODE_ERROR)
• MT4 error 128: Trade timeout (ERR_TRADE_TIMEOUT)

Related MT5 Python functions

• mt5.order_send() in MetaTrader5 Python: place, change or close a trade

All MetaTrader error codes