Saltar a la navegación
Agent Java SDK

Rellenos comerciales perpetuos

Perpetual Trade Fills: Agent Java SDK v0.3.0 integración, ejemplos, parámetros y semántica de respuesta.

Ver como Markdown

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.*;

listPerpetualTrades

Modelo de solicitud: PerpetualTradesRequest.

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

Campos de solicitud

CampoJava tipoRequeridoSignificado
platformUserIdsjava.util.List<String>SíProporcione explícitamente entre 1 y 100 ID de usuario únicos de la plataforma pública que pertenezcan al socio actual; la omisión y una matriz vacía no son válidas.
symbolStringNoFiltro de pares comerciales opcional.
orderIdStringNoID de pedido ordinario; no es un número de orden de transferencia de socio.
startTimeLongNoMilisegundos Unix inclusivos; utilice una ventana de historial fija UTC.
endTimeLongNoMilisegundos exclusivos de Unix.
limitIntegerNoPredeterminado 500; 1–1000.
cursorStringNoUtilice el nextCursor devuelto con filtros sin cambios; detenerse cuando hasMore sea falso.

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.

Detalles de llenado comercial

Interfaz: trades. Requiere platformUserIds explícito.

data campotiposignificado
fillIdstringID de detalles de llenado comercial, correspondiente a este registro entityId
tradeIdstringEl ID de transacción coincidente asociado con la transacción; no reemplaza la identificación detallada
orderIdstringEl ID de pedido general al que pertenece este detalle.
positionIdstringID de posición asociada
symbolstringpar comercial
sidestringDirección de compra y venta de este jugador BUY / SELL
roleTypestringCarácter de transacción de este jugador MAKER / TAKER
positionSidestringDirección de posición, explicada según el valor real LONG / SHORT / BOTH etc.
pricestringEste precio de transacción
quantitystringLa cantidad de esta transacción no es la cantidad total del pedido original.
tradeValuestringEl valor nominal de esta transacción proviene del nocional de la transacción.
handlingFeestringLa tarifa de transacción para esta transacción conserva el símbolo fuente y la precisión, y no toma el valor absoluto por sí misma.
realizedPnlstringLas ganancias y pérdidas realizadas correspondientes a esta transacción; no las ganancias y pérdidas flotantes en tiempo real de la posición actual
tradedAtintegerTiempo de transacción, milisegundos; Utilice este campo para filtrar el tiempo.

Un pedido puede tener múltiples ejecuciones, las cuales deben guardarse en detalle. No combine registros de diferentes jugadores/cumple roles mediante tradeId y luego descarte sus identidades de registros.

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