Documentación

Transacción

CuentaRequiere autenticación

Suscríbase a las notificaciones de compra y venta de contratos, depósitos y retiros. El parámetro loginid y algunos campos de contrato se eliminaron, symbol se cambió a underlying_symbol, y action tiene menos valores.

Comparación rápida

AspectoLegacy APINew APIAcción
EndpointtransactiontransactionNinguno
Requiere autenticaciónSíSíNinguno
loginid parámetroOpcionalEliminadoEliminar de las solicitudes
Campo symbolsymbolunderlying_symbolCambie el nombre en su código
Campos de barrerabarrier, high_barrier, low_barrierEliminadoDeje de leer los campos de barrera
display_nameDevueltoEliminadoDeje de leer display_name
Campos de órdenes límitestop_loss, stop_out, take_profitEliminadoDeje de leer estos campos
action valores8 valores4 valoresGestione menos valores

Cambios importantes

1. loginid parámetro eliminado

En la API heredada, loginid seleccionaba la cuenta cuando autorizaba varias cuentas. La nueva API no lo acepta.

Cambio obligatorio: Elimine loginid de sus solicitudes de transaction . Su token selecciona la cuenta.

2. symbol renombrado a underlying_symbol

El objeto transaction devuelve el símbolo como underlying_symbol en lugar de symbol.

Cambio obligatorio: Lea underlying_symbol en lugar de symbol.

3. Se eliminaron los campos de barrera

barrier, high_barrier y low_barrier ya no se devuelven.

Cambio obligatorio: Obtenga las barreras desde proposal_open_contract en su lugar.

4. display_name eliminado

El display_name del símbolo ya no se devuelve.

Cambio obligatorio: Obtenga el nombre del símbolo desde active_symbols en su lugar.

5. stop_loss, stop_out y take_profit eliminados

stop_loss, stop_out y take_profit ya no se devuelven.

Cambio obligatorio: Obtenga las órdenes límite desde proposal_open_contract en su lugar.

6. Menos valores de action

action es buy, sell, deposit o withdrawal. La nueva API ya no devuelve escrow, adjustment, virtual_credit ni transfer.

Cambio obligatorio: Actualice el código que gestiona los valores que la API New ya no devuelve.

Estructura de solicitud

Legacy APIejemplo de solicitud
{
  "transaction": 1,
  "subscribe": 1,
  "loginid": "CR123456",
  "req_id": 1
}
New APIejemplo de solicitud
{
  "transaction": 1,
  "subscribe": 1,
  "req_id": 1
}

Estructura de respuesta

Legacy APIejemplo de respuesta
{
  "echo_req": {
    "transaction": 1,
    "subscribe": 1,
    "loginid": "CR123456",
    "req_id": 1
  },
  "msg_type": "transaction",
  "req_id": 1,
  "subscription": {
    "id": "c84a793b-8a87-7999-ce10-9b22f7ceead3"
  },
  "transaction": {
    "action": "buy",
    "amount": -10,
    "balance": 9990,
    "contract_id": 11542203588,
    "currency": "USD",
    "date_expiry": 1760000300,
    "id": "c84a793b-8a87-7999-ce10-9b22f7ceead3",
    "longcode": "Win payout if Volatility 100 Index is strictly higher than entry spot at 5 minutes after contract start time.",
    "purchase_time": 1760000000,
    "transaction_id": 11542203587,
    "transaction_time": 1760000000,
    "barrier": "S0P",
    "display_name": "Volatility 100 Index",
    "stop_loss": null,
    "stop_out": null,
    "symbol": "R_100",
    "take_profit": null
  }
}
New APIejemplo de respuesta
{
  "echo_req": {
    "transaction": 1,
    "subscribe": 1,
    "req_id": 1
  },
  "msg_type": "transaction",
  "req_id": 1,
  "subscription": {
    "id": "c84a793b-8a87-7999-ce10-9b22f7ceead3"
  },
  "transaction": {
    "action": "buy",
    "amount": -10,
    "balance": 9990,
    "contract_id": 11542203588,
    "currency": "USD",
    "date_expiry": 1760000300,
    "id": "c84a793b-8a87-7999-ce10-9b22f7ceead3",
    "longcode": "Win payout if Volatility 100 Index is strictly higher than entry spot at 5 minutes after contract start time.",
    "purchase_time": 1760000000,
    "transaction_id": 11542203587,
    "transaction_time": 1760000000,
    "underlying_symbol": "R_100"
  }
}

Ejemplos de código

function watchTransactions(loginId) {
  ws.send(JSON.stringify({ transaction: 1, subscribe: 1, loginid: loginId }));

  ws.onmessage = (event) => {
    const response = JSON.parse(event.data);
    if (response.msg_type !== "transaction" || !response.transaction) return;

    const tx = response.transaction;
    console.log(tx.action, tx.amount, tx.symbol, tx.display_name, tx.barrier);
  };
}
Click to open live chat support. Get instant help from our support team.