Ir para a navegação
Agent Java SDK

Preenchimentos comerciais perpétuos

Preenchimentos comerciais perpétuos: integração Agent Java SDK v0.3.0, exemplos, parâmetros e semântica de resposta.

Ver como Markdown

Este guia é direcionado a Agent Java SDK v0.3.0, Java 8+ e ao contrato público marcado. Os exemplos são executados em um back-end de parceiro após a inicialização de client em Início rápido.

Pré-requisitos de exemplo

Os trechos Java compartilham essas importações. Inicialize client usando o Quick Start e obtenha platformUserId da ligação salva. Os exemplos de IDs de usuário/pedido devem ser substituídos por seus próprios valores persistentes.

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

listPerpetualTrades

Modelo de solicitação: 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 solicitação

CampoJava tipoObrigatórioSignificado
platformUserIdsjava.util.List<String>SimForneça explicitamente de 1 a 100 IDs de usuário exclusivos da plataforma pública pertencentes ao parceiro atual; omissão e uma matriz vazia são inválidas.
symbolStringNãoFiltro opcional de pares de negociação.
orderIdStringNãoID de pedido normal; não é um número de ordem de transferência de parceiro.
startTimeLongNãoMilissegundos Unix inclusivos; use uma janela de histórico fixa UTC.
endTimeLongNãoMilissegundos Unix exclusivos.
limitIntegerNãoPadrão 500; 1–1000.
cursorStringNãoUse o nextCursor retornado com filtros inalterados; pare quando hasMore for falso.

O exemplo lê uma página. Para campos obrigatórios, escopo do player, semântica de filtro, limite, cursor e novas tentativas limitadas, siga Visão geral da consulta. Mantenha todos os filtros inalterados durante a paginação; não interprete um erro como um resultado vazio.

Detalhes de preenchimento comercial

Interface: trades. Requer platformUserIds explícito.

Campo datatiposignificado
fillIdstringID de detalhes de preenchimento comercial, correspondente a este registro entityId
tradeIdstringO ID da transação correspondente associado à transação; não substitui o ID detalhado
orderIdstringO ID geral do pedido ao qual esse detalhe pertence
positionIdstringID da posição associada
symbolstringpar de negociação
sidestringA direção de compra e venda deste jogador BUY / SELL
roleTypestringO personagem de transação deste jogador MAKER / TAKER
positionSidestringDireção de posição, explicada de acordo com o valor real LONG / SHORT / BOTH etc.
pricestringEste preço de transação
quantitystringA quantidade desta transação não é a quantidade total do pedido original.
tradeValuestringO valor nominal desta transação provém do valor nocional da transação
handlingFeestringA taxa de transação para esta transação mantém o símbolo de origem e a precisão e não assume o valor absoluto por si só.
realizedPnlstringOs lucros e perdas realizados correspondentes a esta transação; não o lucro e a perda flutuantes em tempo real da posição atual
tradedAtintegerTempo de transação, milissegundos; use este campo para filtragem de tempo

Um pedido pode ter vários preenchimentos, os quais deverão ser salvos detalhadamente. Não mescle registros de diferentes jogadores/preencha funções por tradeId e depois descarte suas identidades de registro.

Exemplo de envelope de resposta

Esta é uma página em branco ilustrativa, não uma amostra de uma negociação concluída. As tabelas de campos específicos de recursos acima descrevem items[].data preenchido.

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

Fonte e guias relacionados