order_calc_profit

Retorna o valor do lucro na moeda da conta para a operação de negociação especificada.

order_calc_profit(
   action,          // tipo de ordem (ORDER_TYPE_BUY ou ORDER_TYPE_SELL)
   symbol,          // nome do símbolo
   volume,          // volume
   price_open,      // preço de abertura
   price_close      // preço de fechamento
   );

Parâmetros

action

[in]  Tipo de ordem, sendo que pode assumir um dos dois valores da enumeração ORDER_TYPE: ORDER_TYPE_BUY ou ORDER_TYPE_SELL. Parâmetro sem nome obrigatório.

symbol

[in]  Nome do instrumento financeiro. Parâmetro sem nome obrigatório.

volume

[in]  Volume da operação de negociação. Parâmetro sem nome obrigatório.

price_open

[in]  Preço de abertura. Parâmetro sem nome obrigatório.

price_close

[in]  Preço de fechamento. Parâmetro sem nome obrigatório.

Valor retornado

Valor real em caso de execução bem-sucedida, caso contrário, None. Informações de erro podem ser obtidas usando last_error().

Observação

A função permite avaliar o resultado de uma operação de negociação na conta corrente e no ambiente de mercado atual. É semelhante a OrderCalcProfit.

Exemplo:

import MetaTrader5 as mt5
# exibimos dados sobre o pacote MetaTrader5
print("MetaTrader5 package author: ",mt5.__author__)
print("MetaTrader5 package version: ",mt5.__version__)
 
# estabelecemos a conexão ao terminal MetaTrader 5
if not mt5.initialize():
    print("initialize() failed, error code =",mt5.last_error())
    quit()
 
# obtemos a moeda da conta
account_currency=mt5.account_info().currency
print("Account currency:",account_currency)
 
# fazemos uma lista de símbolos
symbols = ("EURUSD","GBPUSD","USDJPY")
print("Symbols to check margin:", symbols)
# avaliamos valores de lucro para compras e vendas
lot=1.0
distance=300
for symbol in symbols:
    symbol_info=mt5.symbol_info(symbol)
    if symbol_info is None:
        print(symbol,"not found, skipped")
        continue
    if not symbol_info.visible:
        print(symbol, "is not visible, trying to switch on")
        if not mt5.symbol_select(symbol,True):
            print("symbol_select({}}) failed, skipped",symbol)
            continue
    point=mt5.symbol_info(symbol).point
    symbol_tick=mt5.symbol_info_tick(symbol)
    ask=symbol_tick.ask
    bid=symbol_tick.bid
    buy_profit=mt5.order_calc_profit(mt5.ORDER_TYPE_BUY,symbol,lot,ask,ask+distance*point)
    if buy_profit!=None:
        print("   buy {} {} lot: profit on {} points => {} {}".format(symbol,lot,distance,buy_profit,account_currency));
    else:
        print("order_calc_profit(ORDER_TYPE_BUY) failed, error code =",mt5.last_error())
    sell_profit=mt5.order_calc_profit(mt5.ORDER_TYPE_SELL,symbol,lot,bid,bid-distance*point)
    if sell_profit!=None:
        print("   sell {} {} lots: profit on {} points => {} {}".format(symbol,lot,distance,sell_profit,account_currency));
    else:
        print("order_calc_profit(ORDER_TYPE_SELL) failed, error code =",mt5.last_error())
    print()
 
# concluímos a conexão ao terminal MetaTrader 5
mt5.shutdown()
 
 
Resultado:
MetaTrader5 package author:  MetaQuotes Software Corp.
MetaTrader5 package version:  5.0.29
 
Account currency: USD
Symbols to check margin: ('EURUSD', 'GBPUSD', 'USDJPY')
   buy EURUSD 1.0 lot: profit on 300 points => 300.0 USD
   sell EURUSD 1.0 lot: profit on 300 points => 300.0 USD
 
   buy GBPUSD 1.0 lot: profit on 300 points => 300.0 USD
   sell GBPUSD 1.0 lot: profit on 300 points => 300.0 USD
 
   buy USDJPY 1.0 lot: profit on 300 points => 276.54 USD
   sell USDJPY 1.0 lot: profit on 300 points => 278.09 USD

Veja também

order_calc_margin, order_check