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