> 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 documenta atualmente a etiqueta `v0.1.1` 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 repositório de dependências 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
```

> **Construção de equipas**
>
> Publique o artefacto 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 implementação em produção.

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

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

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

* Confirma o teu agente de produção API URL base com a equipa 6MM .
* Armazenar apiSecret apenas na gestão de segredos do backend.
* Preparar um mapeamento estável entre platformUserId e agentUserId.
* Permitir registos estruturados em torno dos fluxos de ligação, transferência, ordem 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 do cliente do navegador, móvel ou ambiente de trabalho. O SDK assina pedidos privilegiados de Agente API .

<h2 id="example-transfer-funds-in">
  Exemplo: transferir fundos em
</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 pedido de transferência. Se um pedido expirar, consulta a ordem original antes de criar uma nova.

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

| Necessidade                             | Página seguinte                                                         |
| --------------------------------------- | ----------------------------------------------------------------------- |
| Emitir uma credencial Trading Widget    | [Criar Embed Token](/pt-PT/sdk/agent-sdk/java/embed-token)              |
| Verificar as chamadas de retorno de 6MM | [Webhooks & Idempotência](/pt-PT/sdk/security/webhooks-idempotency)     |
| Rever o comportamento de assinatura     | [Segredos e Sessões de Autógrafos](/pt-PT/sdk/security/secrets-signing) |
| Diagnosticar um problema de integração  | [SDK A Resolver Problemas](/pt-PT/sdk/security/troubleshooting)         |