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 |
{ |
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:
|
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:
|
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:
|
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:
|
order | structure | Consulte Evento de orden colocada |
Orden Rechazada |
||
reason |
Una breve descripción del evento, uno de los siguientes:
|
|
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:
|