Órdenes recientes

Este endpoint permite recibir los últimos 100 eventos relacionados con órdenes. Las órdenes se muestran en el mismo orden en que ocurrieron.

Se requiere autenticación.

Endpoint

Tipo de solicitud Claves API permitidas
/api/v3/recentorders
OBTENGA Lectura, Lectura y escritura, Maestro
Argumento Tipo Requerido Descripción
symbol
string No El símbolo del contrato de futuros. 
Llamadas de ejemplo

https://futures.kraken.com/derivatives/api/v3/recentorders

https://futures.kraken.com/derivatives/api/v3/recentorders?symbol=pi_ethusd

Ejemplo de retorno exitoso

 

{
"result" : "success",
"serverTime":"2019-05-09T11:48:27.507Z",
"orderEvents": [
{
"timestamp": 1550250827587,
"event": {
"timestamp": "1550250827587",
"uid": "41803af4-150b-4724-89ac-e9ca65b5a15f",
"orderPlaced": {
"order": {
"uid": "80280424-0aca-4df9-8c0e-a91c59ff15a0",
"accountId": "1234",
"tradeable": "PI_BCHUSD",
"direction": "BUY",
"quantity": "1",
"filled": "0",
"timestamp": "1550250827587",
"limitPrice": "110",
"orderType": "LIMIT",
"clientId": "",
"stopPrice": ""
},
"reason": "NEW_USER_ORDER"
}
}
},
{
"timestamp": 1550250849804,
"event": {
"timestamp": "1550250849804",
"uid": "9d77a9d1-e556-4808-ae87-bc29f47c5196",
"orderCancelled": {
"order": {
"uid": "b83a9c64-9c20-4272-ba49-08543b16497f",
"accountId": "1234",
"tradeable": "PI_BCHUSD",
"direction": "BUY",
"quantity": "1",
"filled": "0",
"timestamp": "1550250827587",
"limitPrice": "110",
"orderType": "LIMIT",
"clientId": "",
"stopPrice": ""
},
"reason": "CANCELLED_BY_USER"
}
}
},
{
"timestamp": 1550663225607,
"event": {
"timestamp": "1550663225607",
"uid": "9b5972c1-19ee-461c-8c6b-a6a7c3eccbd8",
"orderRejected": {
"order": {
"uid": "5f7e2329-37b5-4e46-8b1c-5b3a0bb7bcf8",
"accountId": "1234",
"tradeable": "PI_BCHUSD",
"direction": "BUY",
"quantity": "1",
"filled": "0",
"timestamp": "1550663225607",
"limitPrice": "147",
"orderType": "POST_ONLY",
"clientId": "",
"stopPrice": ""
},
"reason": "POST_WOULD_EXECUTE"
}
}
},
{
"timestamp": 1550700823833,
"event": {
"timestamp": "1550700823833",
"uid": "07392b6e-7a10-485a-82f4-0e9fee25de1b",
"executionEvent": {
"execution": {
"uid": "03f74113-9709-4cef-b3e9-2851bb5d64e9",
"takerOrder": {
"uid": "9b03b740-8ac4-4d0c-972b-e80895e51dce",
"accountId": "1234",
"tradeable": "PI_BCHUSD",
"direction": "BUY",
"quantity": "1",
"filled": "0",
"timestamp": "1550700823833",
"limitPrice": "145.6",
"orderType": "IMMEDIATE_OR_CANCEL",
"clientId": "",
"stopPrice": ""
},
"timestamp": "1550700823833",
"quantity": "1",
"price": "144.2",
"markPrice": "144.05000000000",
"limitFilled": False
}
}
}
}
]
}

Campo

Tipo Descripción
result
string Siempre acierto
serverTime
ISO8601 datetime La fecha y hora del servidor
orderEvents
Array de estructuras 

Un array que contiene estructuras de los siguientes tipos:

  • orderPlaced
  • orderCancelled
  • orderRejected
  • executionEvent
timestamp Marca de tiempo Unix La marca de tiempo del evento
uid UUID El identificador único del evento. 

 

 

Orden colocada

razón

string

Una breve descripción del evento, uno de los siguientes:

  • NEW_USER_ORDER : Una nueva orden que fue colocada por el usuario.
  • LIQUIDATION_ORDER: Una orden colocada por el sistema con motivo de una liquidación
  • LIMIT_FROM_STOP: Una nueva orden límite colocada porque se activó una orden stop
order
estructura La orden asociada con el evento
uid
UUID El identificador único de la orden. 
accountId
integer (formato string) El identificador de la cuenta
tradeable string El símbolo operable del contrato de futuros
direction string Buy para órdenes de compra y SELL para órdenes de venta

quantity

integer positivo (formato string) La cantidad (tamaño) de la orden
filled integer positivo (formato string) La cantidad de la orden ejecutada
timestamp Marca de tiempo Unix (formato string) La marca de tiempo de la orden
limitPrice float positivo (formato string) El precio límite asociado con la orden.
orderType  string

 Uno de los siguientes:

  • LIMIT
  • IMMEDIATE_OR_CANCEL
  • POST_ONLY
  • LIQUIDATION
  • ASSIGNMENT
clientId string  El identificador de orden del cliente o un string vacío.
stopPrice float positivo (formato string) El precio stop de una orden stop. Aplica sólo para órdenes STOP, de lo contrario retorna un string vacío

Orden Cancelada

reason  string Uno de los siguientes:
  • STOP_ORDER_TRIGGERED: Una orden stop que se activa, se cancela a si misma y coloca una nueva orden límite.
  • CANCELLED_BY_USER: El usuario canceló una orden a través de la API
  • CONTRACT_EXPIRED: La orden se canceló porque el contrato que se había adjudicado expiró
  • NOT_ENOUGH_MARGIN: La orden se canceló debido a una falta de fondos en la cuenta de margen
  • DEAD_MAN_SWITCH: La activación del "dead man switch" canceló la orden
  • CANCELLED_BY_ADMIN: La orden fue cancelada por el administrador del sistema
  • MARKET_INACTIVE: El mercado está inactivo y no puede aceptar ninguna orden
order structure Consulte Evento de orden colocada

Orden Rechazada

reason  

Una breve descripción del evento, uno de los siguientes:

  • POST_WOULD_EXECUTE: Se ejecutaría una orden post-only si no se rechaza. Aplica sólo para POST orders
  • IOC_WOULD_NOT_EXECUTE: No se ejecutaría una orden inmediata o de cancelación. Aplica sólo para órdenes IOC (de mercado)
  • WOULD_EXECUTE_SELF: La orden se ejecutaría contra una orden de la misma cuenta.
order structure

Consulte Evento de orden colocada

Ejecución del evento

execution  estructura

La ejecución asociada con el evento

uid UUID

El identificador único de la ejecución

timestamp

Marca de tiempo Unix (formato string) La marca de tiempo de la ejecución
price float positivo (formato string) 

El precio de ejecución

markPrice float positivo (formato string) 

El precio de mercado en el momento

limitFilled Boolean True si la orden maker de la ejecución se completó en su totalidad, de lo contrario False
takerOrder / makerOrder structure Consulte Evento de orden colocada
Ejemplo de retorno fallido
{  
"result":"error",
"serverTime":"2016-02-25T09:45:53.818Z",
   "error":"apiLimitExceeded",
}

Campo

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

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

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