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 é dirigido a Agent Java SDK v0.3.0, Java 8+ e ao contrato público assinalado. Os exemplos são executados num back-end de parceiro após a inicialização de client em Início rápido.

Pré-requisitos de exemplo

Os trechos Java partilham estas importações. Inicialize client utilizando o Quick Start e obtenha platformUserId a partir da ligação guardada. Os exemplos de IDs de utilizador/encomenda devem ser substituídos pelos seus próprios valores persistentes.

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

listPerpetualTrades

Modelo de pedido: 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 1 a 100 IDs de utilizador 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 encomenda normal; não é um número de ordem de transferência de parceiros.
startTimeLongNãoMilissegundos Unix inclusivos; utilize uma janela de histórico fixa UTC.
endTimeLongNãoMilissegundos Unix exclusivos.
limitIntegerNãoPadrão 500; 1–1000.
cursorStringNãoUtilize o nextCursor devolvido com filtros inalterados; parar quando hasMore for falso.

O exemplo lê uma página. Para campos obrigatórios, âmbito do leitor, 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 detalhe de preenchimento comercial, correspondente a este registo entityId
tradeIdstringO ID da transação correspondente associado à transação; não substitui o ID detalhado
orderIdstringO ID geral do pedido ao qual pertence este detalhe
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
positionSidestringSentido de posição, explicado 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 da encomenda 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 prejuízos 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; utilize este campo para filtragem de tempo

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

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