Saltar a la navegación
Agent Java SDK

Agent Java SDK

Agent Java SDK: 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.

Línea base de documentación: SDK v0.3.0, confirmar 54aa3c1. Webhook reglas de recepción adicionales siguen WEBHOOKS.md en fa6c7b6; Esta es una actualización de documentación únicamente, sin un nuevo artefacto SDK que contenga métodos auxiliares de advertencia.

Versión e instalación

ArtículoValor
Etiqueta de origen establev0.3.0
JavaJava 8+
expertoMaven 3.9+
Coordenadascom.sixmm.exchange.sdk:agent:0.3.0

Fuente de alojamiento de GitHub; no hace que estas coordenadas se puedan resolver desde Maven Central. Utilice la instalación local etiquetada o su repositorio de artefactos aprobado.

Lo que cubre el SDK

CategoríaGuiónSDK APIDescripción
Enlace de usuarioVincular usuariobindCrear o recuperar el enlace entre un usuario asociado y un usuario de la plataforma 6MM
Consultas de activosConsultar cuenta de socioqueryAccountConsultar el margen del socio o la cuenta de financiación
Consultas de activosConsultar activos de usuarioqueryUserAssetsConsultar activos del contrato; use withFunding() para incluir saldos de fondos
TransferenciasTransferencia de cantidad fijatransferTransferir fondos hacia o desde 6MM
TransferenciasTransferir todotransferAllOutMover todo el saldo de usuario retirable a la plataforma de socios
TransferenciasOrden inversoreverseRevertir una transferencia exitosa cuando el backend admite un flujo de compensación
Transferenciasorden de consultaqueryOrderConsultar una orden de transferencia por número de orden del socio
TransferenciasListar pedidoslistOrdersHojear órdenes de transferencia para conciliación
WebhookVerificación de firmaWebhookVerifier.verifyVerificar fondos brutos-eventos y órganos de alerta de liquidación; El código de comerciante maneja controles de tiempo, propiedad y deduplicación persistente. Ver Webhook Eventos y advertencias de liquidación.
Cartera de financiaciónTransferencia de fondoswalletTransferSocio ↔ Financiamiento o Financiamiento ↔ Contrato; confirmar el estado devuelto
Cartera de financiaciónEstado de transferencia de fondosqueryWalletTransferRecuperar una operación de financiación utilizando su número de orden de socio original
Entrada comercialEntrada directa URLcreateEntryUrlCree un SSO URL único para el modo de redireccionamiento
Entrada comercialInsertar tokencreateEmbedTokenCree un token de corta duración para el modo Trading Widget tokenProvider
Datos perpetuosÓrdenes perpetuas actualeslistCurrentPerpetualOrdersConsultar pedidos NORMAL o CONDITIONAL actuales
Datos perpetuosHistorial de pedidos perpetuolistPerpetualOrderHistoryTerminal de consulta NORMAL o CONDITIONAL pedidos
Datos perpetuosComercios perpetuoslistPerpetualTradesConsulta de rellenos comerciales para una lista pública explícita de jugadores
Datos perpetuosPosiciones perpetuas actualeslistCurrentPerpetualPositionsConsultar posiciones actuales
Datos perpetuosHistorial de posiciones perpetuaslistPerpetualPositionHistoryConsulta de posiciones cerradas
Datos perpetuosLibro mayor de cuentas perpetuaslistPerpetualLedgerConsultar registros de cambio de saldo de contrato individuales
Tasas de referencia fiduciariasLista de monedas fiduciarias admitidaslistSupportedFiatCurrenciesEnumere las monedas fiduciarias actualmente convertibles a USDT
Tasas de referencia fiduciariasConsultar tipos de cambio de referenciaqueryExchangeRatesConsultar ratios de referencia diarios entre moneda fiduciaria y USDT para todas las monedas o para algunas monedas seleccionadas
Información de servicioVersión de servicioversionInformación de la versión del servicio del Agente de consultas

Configuración

Obtenga los siguientes valores de 6MM antes integrando.

ArtículoEjemploDescripción
baseUrlhttps://agent-api.6mm.comAgente API base URL, sin barra diagonal
agentCodeAGENT001código de socio
apiSecretyour-api-secretAPI secreto de firma. Manténgalo solo en el backend
defaultCurrencyUSDTMoneda predeterminada, normalmente USDT
webhookUrlhttps://partner.example.com/6mm/webhookDevolución de llamada del comerciante URL compartida por los cuatro tipos de eventos; envío por cuerpo event, sin advertencia por separado URL.

Recomendaciones de producción:

  • Utilice HTTPS para los puntos finales del Agente API y webhook.
  • Almacene apiSecret en un administrador secreto, centro de configuración o variable de entorno.
  • Mantenga la hora del servidor sincronizada, preferiblemente con NTP.
  • Conserve todos los números de pedido de los socios y manténgalos únicos a nivel mundial.
  • Nunca envíe apiSecret a navegadores, aplicaciones, miniprogramas o código fuente de interfaz.

Campos de firma automática

Para llamadas firmadas del Agente API, el SDK inyecta automáticamente:

CampoFuenteDescripción
agentCodeAgentClientConfig.agentCodecódigo de socio
timestampMarca de tiempo Unix actual UTCArtículos de segunda clase
nonceGenerador aleatorio seguroProtección de repetición
signHMAC-SHA256Solicitar firma
currencydefaultCurrencySe completa cuando las solicitudes de transferencia/cuenta omiten moneda

Reglas de firma:

  1. Excluir sign.
  2. Excluir valores vacíos.
  3. Ordenar claves por orden ASCII.
  4. Únase como k=v&k2=v2.
  5. Calcula HMAC-SHA256 hexadecimal con apiSecret.

Los valores de la matriz se serializan como JSON compacto antes de unirse a la carga útil de firma. Por ejemplo, platformUserIds firma como ["1188041528"], dando platformUserIds=["1188041528"] en la carga útil k=v. Preservar el orden de los elementos de la matriz, las comillas dobles y los ID de cadenas; no inserte espacios de formato ni utilice Java List.toString() (como [1188041528]). El SDK maneja esta serialización automáticamente.

El código comercial normal no debe calcular firmas ni configurarse manualmente agentCode, timestamp, nonce o sign.

Guías fuente y relacionadas