Calculadora de futuros

Se o tamanho do contrato for zero ou negativo, a tarefa falha com invalid_input e não é cobrada, porque um multiplicador não positivo não descreve um contrato listado.

O que o lucro ou prejuízo de um contrato futuro realmente mede

Combine os números com a própria planilha de margem se precisar da variação de margem de uma sessão; este endpoint devolve só o P&L em caixa da operação fechada.

Contrato de entrada, forma da resposta e comportamento de erro

Exemplo: dois contratos comprados de tamanho cinquenta, abertos a quatro mil e quinhentos e fechados a quatro mil quinhentos e doze com um quarto, geram lucro de mil duzentos e vinte e cinco, porque doze pontos e um quarto vezes cinquenta vezes dois é esse caixa. Envie por POST um corpo JSON com quatro campos obrigatórios e um lado opcional. contract_size é o multiplicador e deve ser um número finito estritamente maior que zero; os alias multiplier, size, point_value e contract_multiplier apontam para o mesmo campo. Tamanho de contrato zero ou negativo falha com invalid_input nomeando contract_size, porque um contrato listado não pode ter valor de ponto não positivo e essas falhas não são cobradas. entry_price é o negócio em que a posição foi aberta e deve ser um número finito; alias entry e open_price. exit_price é o negócio em que a posição foi fechada e deve ser um número finito; alias exit e close_price. Ambos os preços podem ser negativos para que uma commodity que imprime abaixo de zero ainda tenha resultado bem definido. contracts é o número de contratos e deve ser um número finito estritamente maior que zero; alias quantity, n e num_contracts. position é o enumerado fechado long ou short e vale long se omitido; alias side e direction. Qualquer outra cadeia falha com invalid_input nomeando position. Cada campo numérico pode chegar como número JSON ou como cadeia numérica. Campos ausentes, cadeias vazias e valores não finitos falham com invalid_input nomeando o campo. Se a validação passa, o corpo ecoa as cinco entradas, informa price_change como saída menos entrada, profit_loss_per_contract, o profit_loss completo, notional_entry e notional_exit, outcome como profit, loss ou breakeven, e uma cadeia curta de fórmula.

Onde uma calculadora de P&L de contrato futuro se justifica

Mesas e traders independentes usam uma calculadora de contrato futuro para recapitular um ticket fechado sem abrir uma planilha que silencie o multiplicador. Diários de trade e pipelines de backtest precisam de um contrato parse pequeno que nunca invente comissão, nunca chame um fornecedor de cotação e nunca derive se mais tarde alguém reescrever um produto de quatro fatores. Validação falha não consome saldo. Plataformas de sala de aula e de preparação para exame enviam tamanho do contrato, entrada, saída e contratos, e fixam profit_loss para um corretor pontuar tanto a aritmética quanto o sinal comprado versus vendido, em vez de aceitar uma diferença de preço crua como se fosse caixa. Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída. Mantenha o tamanho do contrato estritamente positivo, o número de contratos estritamente positivo, position no enumerado fechado, fixe o profit_loss arredondado nos testes e você terá um resultado de futuros reproduzível para dever de casa, checagens de blotter e workers de borda sem montar um motor de compensação próprio.