Órdenes recientes – Kraken

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

Artículos relacionados