> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# Java Início Rápido

<h2 id="install">
  Instalação
</h2>

A fonte pública SDK atualmente documenta `v0.1.1` de etiquetas com estas coordenadas Maven:

```xml
<dependency>
    <groupId>com.sixmm.exchange.sdk</groupId>
    <artifactId>agent</artifactId>
    <version>0.1.1</version>
</dependency>
```

O GitHub não funciona como um repositório de dependência do Maven. Instale o código-fonte marcado localmente antes de resolver a dependência:

```bash
git clone https://github.com/6mm-com/agent-java-sdk.git
cd agent-java-sdk
git checkout v0.1.1
mvn install
```

> **Equipes de construção**
>
> Publique o artefato aprovado no repositório Maven da sua organização para CI, testes e builds de produção. Confirme a versão aprovada com 6MM antes da implantação em produção.

Exemplos de código-fonte e uso estão disponíveis no repositório oficial Java SDK :

\[6mm-com/agent-java-sdk] ([https://github.com/6mm-com/agent-java-sdk](https://github.com/6mm-com/agent-java-sdk))

<h2 id="before-you-start">
  Antes de começar
</h2>

* Confirme seu agente de produção API URL base com a equipe 6MM .
* Armazene apiSecret apenas no gerenciamento de segredos do backend.
* Prepare um mapeamento estável entre platformUserId e agentUserId.
* Habilitar logs estruturados em torno dos fluxos bind, transfer, order e webhook.

<h2 id="initialize-client">
  Inicializar cliente
</h2>

```java
import com.sixmm.agent.AgentClient;
import com.sixmm.agent.AgentClientConfig;

AgentClient client = new AgentClient(AgentClientConfig.builder()
        .baseUrl("https://agent-api.6mm.com")
        .agentCode("AGENT001")
        .apiSecret("your-api-secret")
        .defaultCurrency("USDT")
        .build());
```

> **Apenas backend**
>
> Não inicialize o Agent SDK a partir do código cliente do navegador, celular ou desktop. O SDK assina solicitações privilegiadas do Agente API .

<h2 id="example-transfer-funds-in">
  Exemplo: transferir fundos para
</h2>

```java
TransferResponse resp = client.transfer(TransferRequest.fixed(
        "AGT-ORDER-1001",
        "agent-user-001",
        Direction.IN,
        "USDT",
        "10.00"));
```

Use um número de pedido único do lado do parceiro para cada solicitação de transferência. Se uma solicitação expirar, consulte a ordem original antes de criar uma nova.

<h2 id="next-steps">
  Próximos passos
</h2>

| Need                                                    | Próxima página                                                         |
| ------------------------------------------------------- | ---------------------------------------------------------------------- |
| Emita uma credencial Trading Widget                     | \[Criar Token de Incorporação] (/sdk/agent-sdk/java/embed-token)       |
| Verifique os retornos de chamada de 6MM                 | \[Ganchos de Teia & Idempotência] (/sdk/security/webhooks-idempotency) |
| Revise o comportamento de assinatura                    | \[Segredos e Assinaturas] (/sdk/security/secrets-signing)              |
| Diagnosticar um problema de integração                  | \[SDK Solucionando problemas ] (/sdk/security/troubleshooting)         |
| <h2 id="localized-page-links">Páginas relacionadas</h2> |                                                                        |

* [Criar Embed Token](/pt-BR/sdk/agent-sdk/java/embed-token)
* [Verificação de Assinatura em Webhook e Idempotência](/pt-BR/sdk/security/webhooks-idempotency)
* [Agent SDK Segredos e HMAC Assinatura](/pt-BR/sdk/security/secrets-signing)
* [SDK Solução de Problemas de Integração](/pt-BR/sdk/security/troubleshooting)