Integração de negociação de segundos

Este guia é direcionado a Agent Java SDK v0.3.0 e Java 8+.

Preparar identidade, autenticação e fundos

A negociação em segundos usa a mesma vinculação de usuário e autenticação de entrada que a negociação perpétua. Utiliza saldos de financiamento; margem perpétua usa saldos contratuais. Configure o produto/modo de front-end e o ambiente de fundos de back-end separadamente.

Inicialize client usando Início rápido. Salve o mapeamento do usuário vinculado e obtenha o ID do usuário parceiro na sessão de back-end autenticada.

Redirecionar entrada

import com.sixmm.agent.model.CreateEntryUrlRequest;
import com.sixmm.agent.model.CreateEntryUrlResponse;
CreateEntryUrlResponse entry = client.createEntryUrl(
        CreateEntryUrlRequest.of("merchant-user-001")
                .withRedirectPath("/zh-CN/up-down?tradingMode=demo")
                .withReturnUrl("https://merchant.example/markets"));
String webUrl = entry.webUrl;

O SDK chama POST /v1/agent/create-entry-url. Retorne webUrl ao frontend do parceiro e abra-o imediatamente. expireAt usa segundos Unix. Um ingresso tem vida curta e é único; obter outro após expiração ou consumo.

Use as rotas de front-end reais fornecidas por 6MM. redirectPath é um caminho relativo da plataforma começando com /; returnUrl é um parceiro absoluto HTTP/HTTPS URL. Um ticket de entrada autentica o usuário e não executa uma transferência.

Entrada incorporada

Use o fluxo partner-token e tokenProvider existente. Não há token específico para previsão. Crie o widget com o page e tradingMode desejados e use seu channelId atual ao chamar o back-end do parceiro.

import com.sixmm.agent.model.CreateEmbedTokenRequest;
import com.sixmm.agent.model.CreateEmbedTokenResponse;
String channelId = "tw_example_channel";
CreateEmbedTokenResponse auth = client.createEmbedToken(
        CreateEmbedTokenRequest.of("merchant-user-001", channelId));
String embedToken = auth.embedToken;
long expireAt = auth.expireAt;

O SDK chama POST /v1/agent/create-embed-token. symbol é opcional; ele não escolhe um produto de negociação de segundos. A seleção do produto pertence ao frontend. O token não seleciona um ambiente de fundos nem altera saldos.

Exemplo completo de front-end

Essas opções foram verificadas em relação ao tempo de execução público Trading Widget 1.8.0 em 10/10/2026. As versões do widget e do Agent Java SDK são independentes.

<div id="seconds-widget" style="width: 100%; height: 720px"></div>
<script src="https://app.6mm.com/sdk/trading-widget/v1/index.js"></script>
<script>
  const page = 'up-down';
  const tradingMode = 'demo';
  const capabilities = TradingWidget.capabilities;
  if (!capabilities?.partnerToken ||
      !capabilities.pages?.includes(page) ||
      !capabilities.tradingModes?.includes(tradingMode)) {
    throw new Error('Trading Widget SDK does not support the requested page or mode');
  }
  const widget = TradingWidget.create('#seconds-widget', {
    baseUrl: 'https://app.6mm.com',
    page,
    tradingMode,
    theme: 'dark',
    locale: 'zh-CN',
    auth: {
      mode: 'partner-token',
      tokenProvider: async ({ channelId }) => {
        // Partner-owned endpoint; derive the user from the backend session.
        const response = await fetch('/api/seconds/embed-token', {
          method: 'POST',
          credentials: 'same-origin',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify({ channelId }),
        });
        if (!response.ok) {
          throw new Error('Failed to request embed token');
        }
        const result = await response.json();
        if (typeof result.embedToken !== 'string' || !result.embedToken.trim() ||
            !Number.isFinite(result.expireAt) || result.channelId !== channelId) {
          throw new Error('Invalid embed token response');
        }
        return {
          embedToken: result.embedToken,
          expireAt: result.expireAt,
          channelId: result.channelId,
        };
      },
    },
    onReady() {
      console.log('Trading widget ready');
    },
    onError(error) {
      console.error('Trading widget error', error.code);
    },
  });
  window.addEventListener('beforeunload', () => widget.destroy());
</script>

Resposta de back-end do parceiro

/api/seconds/embed-token é um endpoint de propriedade do parceiro, não um novo 6MM API. Autentique a sessão, derive agentUserId do lado do servidor e chame createEmbedToken. Retorne esta estrutura de nível superior:

{
  "embedToken": "short-one-time-token",
  "expireAt": 1791590700,
  "channelId": "tw_xxx"
}

Use o expireAt real da resposta do agente, não o valor ilustrativo. A resposta do agente não contém channelId; seu backend ecoa o valor da solicitação atual. Se o seu API agrupar os resultados em data, desembrulhe essa camada antes de retornar de tokenProvider. Rejeite falhas de negócios em vez de retornar um objeto de sucesso inválido.

Cada inicialização ou renovação obtém um novo token. Nunca armazene em cache e troque o mesmo token novamente ou coloque-o em um URL. Reutilize o mesmo canal de instância durante a renovação; use o novo canal após recriar a instância.

Combine o ambiente dos fundos

Um frontend demo requer solicitações de fundos simuladas com environment=SIMULATED. Um frontend real requer fundos de produção. Nem tradingMode nem a criação de token alteram a meta de fundos de back-end.

Ao trocar de usuário ou modo de negociação, destrua o widget antigo e crie uma nova instância. Consulte saldos de financiamento, transfira fundos e confirme o resultado final por meio do endpoint de status específico do financiamento antes de tratar o usuário como financiado.

Ver Carteira de financiamento e Guia ambiental.

Fonte e guias relacionados

• Fonte oficial v0.3.0
• Visão geral da consulta e paginação
• Carteira de financiamento
• Guia de atualização