Atualização de contrato
NegociaçãoAutenticação ObrigatóriaAtualizar parâmetros de contrato como take profit e stop loss. O parâmetro loginid foi removido, o objeto de resposta agora obrigatório e novo campo display_order_amount adicionado.
3 Alterações Disruptivas
loginid foi removido e o objeto de resposta contract_update é agora obrigatório.Comparação rápida
Alterações de rutura
1. Parâmetro loginid removido
O parâmetro loginid foi removido na Nova versão. Este parâmetro era anteriormente usado para especificar para que conta atualizar contratos quando vários tokens eram fornecidos durante a autorização.
Alteração obrigatória: Remova o campo loginid dos seus pedidos contract_update. A seleção de conta é agora gerida através do token de autorização.
2. objeto contract_update agora obrigatório na resposta
O objeto contract_update é agora um campo obrigatório no nível raiz da resposta.
Alteração obrigatória: Pode agora confiar que o objeto contract_update está sempre presente em respostas bem-sucedidas. Remova quaisquer verificações condicionais da sua existência.
3. Novo campo display_order_amount adicionado
Um novo campo de string display_order_amount foi adicionado aos objetos stop_loss e take_profit na resposta.
Alteração obrigatória: Opcionalmente, pode usar este novo campo para exibir quantidades de encomendas na IU em vez de formatar o número order_amount você mesmo.
Estrutura de pedido
{
"contract_update": 1,
"contract_id": 123456789,
"limit_order": {
"stop_loss": 15.00,
"take_profit": 25.00
},
"loginid": "CR123456"
}{
"contract_update": 1,
"contract_id": 123456789,
"limit_order": {
"stop_loss": 15.00,
"take_profit": 25.00
}
}Estrutura de resposta
{
"contract_update": {
"stop_loss": {
"display_name": "Stop loss",
"order_amount": 15.00,
"order_date": 1234567890,
"value": "1234.56"
},
"take_profit": {
"display_name": "Take profit",
"order_amount": 25.00,
"order_date": 1234567890,
"value": "1256.78"
}
},
"echo_req": { "contract_update": 1, "contract_id": 123456789 },
"msg_type": "contract_update"
}{
"contract_update": {
"stop_loss": {
"display_name": "Stop loss",
"display_order_amount": "15.00 USD",
"order_amount": 15.00,
"order_date": 1234567890,
"value": "1234.56"
},
"take_profit": {
"display_name": "Take profit",
"display_order_amount": "25.00 USD",
"order_amount": 25.00,
"order_date": 1234567890,
"value": "1256.78"
}
},
"echo_req": { "contract_update": 1, "contract_id": 123456789 },
"msg_type": "contract_update"
}Exemplos de código
async function updateContract(contractId, loginId = null) {
const request = {
contract_update: 1,
contract_id: contractId,
limit_order: {
stop_loss: 15.00,
take_profit: 25.00
}
};
// Add loginid if provided (for multi-account)
if (loginId) {
request.loginid = loginId;
}
ws.send(JSON.stringify(request));
ws.onmessage = (event) => {
const response = JSON.parse(event.data);
if (response.msg_type === "contract_update") {
// contract_update may be undefined
if (response.contract_update) {
const sl = response.contract_update.stop_loss;
const tp = response.contract_update.take_profit;
// Format order_amount manually
console.log("Stop Loss:", sl?.order_amount);
}
}
};
}Alguma outra questão? Entrar em contacto