Deriv API
Documentación

Extracto

CuentaRequiere autenticación

Obtenga extracto de cuenta mostrando transacciones. El parámetro loginid eliminado, campos relacionados con transferencias eliminados, y validación de action_type relajada.

Comparación rápida

AspectoLegacy APINew APIAcción
EndpointstatementstatementNinguno
Requiere autenticaciónNinguno
parámetro loginidSoportadoEliminadoEliminar de las solicitudes
Campos de transferenciafees, from, toEliminadoActualizar manejo de respuesta
Campos de respuestaOpcionalObligatorioSimplificar verificaciones nulas

Cambios importantes

1. loginid parámetro eliminado

El parámetro loginid usado para autorización de múltiples tokens ha sido eliminado de la solicitud.

Cambio requerido: Remove loginid from your request payloads. Authenticate with the specific account token instead.

2. Campos relacionados con transferencias eliminados

Los siguientes campos ya no se devuelven en los objetos de transacción:

  • app_id, fees, from, to, withdrawal_details (eliminado)

3. action_type validación enum eliminada

El parámetro action_type ya no valida contra un enum fijo. La nueva API acepta cualquier valor de cadena.

4. Campos de respuesta ahora obligatorios

La respuesta ahora garantiza ciertos campos: statement.count, statement.transactions, y para cada transacción: action_type, amount, balance_after, transaction_id, y transaction_time.

Estructura de solicitud

Legacy APIejemplo de solicitud
{
  "statement": 1,
  "action_type": "buy",
  "limit": 25,
  "loginid": "CR123456"
}
New APIejemplo de solicitud
{
  "statement": 1,
  "action_type": "buy",
  "limit": 25
}

Estructura de respuesta

Legacy APIejemplo de respuesta
{
  "statement": {
    "count": 100,
    "transactions": [
      {
        "action_type": "buy",
        "amount": -10.50,
        "app_id": 1234,
        "fees": { "amount": 0.5 }
      }
    ]
  },
  "msg_type": "statement"
}
New APIejemplo de respuesta
{
  "statement": {
    "count": 100,
    "transactions": [
      {
        "action_type": "buy",
        "amount": -10.50,
        "balance_after": 989.50,
        "transaction_id": 987654321,
        "transaction_time": 1234567890
      }
    ]
  },
  "msg_type": "statement"
}

Ejemplos de código

async function getStatement(loginid) {
  const request = {
    statement: 1,
    loginid: loginid
  };

  ws.send(JSON.stringify(request));

  ws.onmessage = (event) => {
    const response = JSON.parse(event.data);
    if (response.msg_type === 'statement') {
      response.statement.transactions.forEach(t => {
        if (t.fees) console.log('Fee:', t.fees.amount);
      });
    }
  };
}
Click to open live chat support. Get instant help from our support team.