Órdenes perpetuas

Esta guía está dirigida a Agent Java SDK v0.3.0, Java 8+ y el contrato público etiquetado. Los ejemplos se ejecutan en un backend asociado después de inicializar client en Inicio rápido.

Requisitos previos de ejemplo

Los fragmentos Java comparten estas importaciones. Inicialice client usando el Inicio rápido y obtenga platformUserId del enlace guardado. Los ID de usuario/pedido de ejemplo deben reemplazarse con sus propios valores persistentes.

import com.sixmm.agent.*;
import com.sixmm.agent.model.*;
import java.util.*;

listCurrentPerpetualOrders

Modelo de solicitud: CurrentPerpetualOrdersRequest.

import com.sixmm.agent.model.CurrentPerpetualOrdersRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
CurrentPerpetualOrdersRequest request = new CurrentPerpetualOrdersRequest();
request.platformUserIds = Collections.singletonList("1188041528");
request.limit = 100;
request.orderCategory = "NORMAL";
request.symbol = "BTCUSDT";
PerpetualResponse response = client.listCurrentPerpetualOrders(request);
System.out.println(response.data.items.size());
System.out.println(response.data.hasMore);
System.out.println(response.data.nextCursor);

Campos de solicitud

El ejemplo lee una página. Para campos obligatorios, alcance del reproductor, semántica de filtro, límite, cursor y reintentos limitados, siga Resumen de consultas. Mantenga todos los filtros sin cambios mientras busca; no interprete un error como un resultado vacío.

listPerpetualOrderHistory

Modelo de solicitud: PerpetualOrderHistoryRequest.

import com.sixmm.agent.model.PerpetualOrderHistoryRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
PerpetualOrderHistoryRequest request = new PerpetualOrderHistoryRequest();
request.platformUserIds = Collections.singletonList("1188041528");
request.limit = 100;
request.orderCategory = "NORMAL";
request.symbol = "BTCUSDT";
request.endTime = System.currentTimeMillis();
request.startTime = request.endTime - 3_600_000L;
PerpetualResponse response = client.listPerpetualOrderHistory(request);
System.out.println(response.data.items.size());
System.out.println(response.data.hasMore);
System.out.println(response.data.nextCursor);

Campos de solicitud

El ejemplo lee una página. Para campos obligatorios, alcance del reproductor, semántica de filtro, límite, cursor y reintentos limitados, siga Resumen de consultas. Mantenga todos los filtros sin cambios mientras busca; no interprete un error como un resultado vacío.

Órdenes ordinarias: actualidad e historia

Actual: orders/current + orderCategory=NORMAL; Historial: orders/history + orderCategory=NORMAL.

El historial de pedidos incluye pedidos ordinarios cancelados. No se puede considerar que cada registro esté completamente completo basándose únicamente en el nombre de la interfaz. La página del pedido actual es una consulta de estado actual, no un flujo de eventos de pedido.

Órdenes condicionales: actual e histórica.

Actual: orders/current + orderCategory=CONDITIONAL; Historial: orders/history + orderCategory=CONDITIONAL. Ambos requieren platformUserIds explícito.

Las órdenes condicionales no proporcionan filledQuantity, remainingQuantity, avgFilledPrice para órdenes ordinarias. Si necesita el estado de las transacciones de los pedidos ordinarios después de la activación, consulte los pedidos/transacciones ordinarias a través de generatedOrderId y no infiera el volumen de transacciones del estado del pedido condicional.

Ejemplo de sobre de respuesta

Esta es una página vacía ilustrativa, no una muestra de una operación completada. Las tablas de campos específicos de recursos anteriores describen items[].data.

{"code":0,"message":"success","data":{"items":[],"nextCursor":"","hasMore":false}}

Guías fuente y relacionadas

• Fuente oficial v0.3.0
• Descripción general de consultas y paginación
• Cartera de financiación
• Guía de actualización