Historial de órdenes

Este endpoint le permite recibir el historial de órdenes en un archivo con formato CSV.

 

Endpoint

 Tipo de solicitud Claves API permitidas
/api/v3/historicorders
 OBTENGA Lectura, Lectura y escritura, Maestro
Argumento Tipo Requerido Descripción
después
 Unidad de marca de tiempo No Incluir eventos después de este punto en el tiempo
antes
 Unida a la marca de tiempo No Incluir eventos antes de este punto en el tiempo
symbol
 string No El símbolo del contrato de futuros
Llamadas de ejemplo

https://futures.kraken.com/derivatives/api/v3/historicorders?after=1550250845144&before=1550250845144&symbol=pi_xbtusd

https://futures.kraken.com/derivatives/api/v3/historicorders?after=1550250845144&before=1550250845144&symbol=pi_xbtusd&orderType=limit
Ejemplo de retorno exitoso

Un archivo que contiene el historial de órdenes en formato CSV. Haga clic aquí para descargar un archivo de ejemplo.

Campo

 Tipo Descripción
indicación de fecha y hora
 Marcas de tiempo Unix La marca de tiempo del evento de la orden
uid
 UUID Una estructura que contiene información en la solicitud de envío de orden, como se muestra a continuación
event_type
 string

Uno de los siguientes:

  • ORDER_PLACED
  • ORDER_CANCELLED
  • ORDER_REJECTED
  • EXECUTION
order_uid UUID El identificador único de la orden
order_tradeable string El símbolo operable del contrato de futuros
order_direction string BUY para una orden de compra y SELL para una de venta
order_quantity float positivo Cantidad de la orden (tamaño)
order_filled
 float positivo La cantidad de la orden ejecutada
order_timestamp
 Marcas de tiempo Unix La marca de tiempo de la orden
order_type
 string

Uno de los siguientes:

  • LIMIT
  • IMMEDIATE_OR_CANCEL
  • POST_ONLY
  • LIQUIDATION
  • ASSIGNMENT
  • STOP
order_client_id
  string El identificador de orden proporcionado por el cliente
order_stop_price  float positivo El precio stop de la orden.
info  string

Uno de los siguientes:

  • MAKER_ORDER 
  • TAKER_ORDER
algo_id  string El identificador del algoritmo que colocó la orden
execution_timestamp  Marcas de tiempo Unix La marca de tiempo de la ejecución
execution_quantity  integer positivo La cantidad ejecutada
execution_price float positivo El precio al que las órdenes fueron ejecutadas
execution_mark_price  float positivo El precio de mercado en el momento de la ejecución
execution_limit_filled  boolean true si la orden del maker se ejecutó en su totalidad, de lo contrario ftambién

 

Ejemplo de retorno no exitoso
{  
"result":"error",
"serverTime":"2016-02-25T09:45:53.818Z",
   "error":"apiLimitExceeded",
}

Campo

 Tipo Descripción
result
 String Siempre un error
serverTime
 ISO8601 datetime La hora y fecha del servidor
error
 string

La razón por la que falló la llamada de API, pude ser cualquiera de estas:

  • apiLimitExceeded: se ha excedido el límite API para la dirección IP solicitante
  • authenticationError: la solicitud no pude ser autenticada
  • accountInactive: la cuenta de Crypto Facilities a la que se refiere la solicitud está inactiva
  • requiredArgumentMissing: falta un argumento requerido
  • invalidArgument: <argument>:argument "<argument>" es inválido
  • nonceBelowThreshold: <threshold> el nonce proporcionado se encuentra por debajo del <threshold>
  • nonceDuplicate: <duplicate> el nonce proporcionado es un duplicado y ha sido utilizado en una solicitud previa