Ir para a navegação
Agent Java SDK

Razão de contrato

Razão de contrato: 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.*;

listPerpetualLedger

Modelo de solicitação: PerpetualLedgerRequest.

import com.sixmm.agent.model.PerpetualLedgerRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
PerpetualLedgerRequest request = new PerpetualLedgerRequest();
request.platformUserIds = Collections.singletonList("1188041528");
request.limit = 100;
request.endTime = System.currentTimeMillis();
request.startTime = request.endTime - 3_600_000L;
PerpetualResponse response = client.listPerpetualLedger(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>Condicional1–100 IDs públicos exclusivos; necessário para preenchimentos e pedidos condicionais. Omitir consultas suportadas para escopo de player direto; [] é inválido.
assetTypeStringNãoClassificação dos ativos conforme retornado pelo razão; não assuma USDT.
changeTypeStringNãoTipo de mudança de negócio razão, preservando os valores de origem.
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.

Registros do razão de contrato

Interface: account/ledger. Os dados retornados contêm apenas os 11 campos comerciais a seguir e não carregam os sinalizadores booleanos do pedido.

Campo datatiposignificado
ledgerIdstringO razão de origem registra o ID da transação; a mesma transação pode ser dividida em vários detalhes
symbolstringPar de negociação relacionado, pode ser omitido se não estiver relacionado
assetTypestringTipo de ativo, salvo por valor de origem; usado para classificação de ativos, não inferido por padrão USDT
changeTypestringTipo de negócio de mudança de conta, salvo de acordo com o valor de origem, como taxa de manuseio, lucros e perdas, transferência; pode ser filtrado pelo mesmo campo
amountstringO valor da alteração deste detalhe, um número positivo indica um aumento, um número negativo indica uma diminuição; a precisão é mantida
walletBalanceBeforestringO saldo da carteira antes da alteração da conta registrado neste detalhe
walletBalanceAfterstringO saldo da carteira após a alteração da conta registrado neste detalhe
frozenBalanceBeforestringO saldo congelado registrado antes da mudança de conta é registrado neste detalhe
frozenBalanceAfterstringO saldo congelado registrado neste detalhe após a mudança de conta
referenceIdstringNúmero comercial associado; interpretado como changeType e não pode ser considerado uniformemente como pedido orderId; “0” indica que a fonte não possui um número associado válido
createdAtintegerHora de criação dos detalhes de alteração da conta, milissegundos; este campo é usado para filtragem de tempo nesta interface

Utilize o saldo antes e depois da alteração da conta retornada pela interface. Diferentes changeType têm semânticas diferentes e não se pode presumir que cada valor seja igual a walletBalanceAfter - walletBalanceBefore. A exibição/resumo dos registros contábeis deve manter o tipo e a identidade detalhada.

Aqui está um exemplo do formato, usando um ID e valor fictícios:

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "platformUserId": "1188041528",
        "entityType": "ACCOUNT_LEDGER",
        "entityId": "900001",
        "data": {
          "ledgerId": "ledger-example-001",
          "symbol": "BTCUSDT",
          "assetType": "USDT",
          "changeType": "HANDLING_FEE",
          "amount": "-0.10000000",
          "walletBalanceBefore": "100.00000000",
          "walletBalanceAfter": "99.90000000",
          "frozenBalanceBefore": "0.00000000",
          "frozenBalanceAfter": "0.00000000",
          "referenceId": "800001",
          "createdAt": 1791590400000
        }
      }
    ],
    "nextCursor": "",
    "hasMore": false
  }
}

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