> 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.

# Usuário e Conta

> Use 6MM endpoints de usuário e conta para recuperar perfis, saldos, estado da conta, permissões e informações vinculadas a parceiros da conta.

A menos que especificado de outra forma, os seguintes endpoints podem usar JWT ou API Key assinatura.

<h2 id="user-info">
  Informações do Usuário
</h2>

```http
GET /v1/private/user/info
```

Campos de resposta:

| Campo                  | Tipo   | Descrição             |
| ---------------------- | ------ | --------------------- |
| `userInfo.userId`      | string | ID de usuário externo |
| `userInfo.username`    | string | Nome de usuário       |
| `userInfo.agentId`     | int64  | ID do Agente          |
| `userInfo.vipLevel`    | int64  | VIP nível             |
| `userInfo.lastLoginAt` | int64  | Último tempo de login |
| `userInfo.lastLoginIp` | string | Último login IP       |

<h2 id="user-assets">
  Recursos de Usuário
</h2>

```http
GET /v1/private/user/asset
```

Campos de resposta:

| Campo                     | Tipo   | Descrição                             |
| ------------------------- | ------ | ------------------------------------- |
| `userAsset.userId`        | string | ID de usuário externo                 |
| `userAsset.assetType`     | string | Tipo de ativo                         |
| `userAsset.walletBalance` | string | Saldo da carteira                     |
| `userAsset.frozenMargin`  | string | Margem congelada por ordens pendentes |
| `userAsset.usedMargin`    | string | Margem usada pelas posições           |

<h2 id="create-listenkey">
  Crie listenKey
</h2>

```http
POST /v1/private/user/listen-key
```

Cria uma chave de autenticação para fluxos privados WebSocket .

<h2 id="renew-listenkey">
  Renovar listenKey
</h2>

```http
PUT /v1/private/user/listen-key
```

Estende listenKey validade.

<h2 id="close-listenkey">
  Fechar listenKey
</h2>

```http
DELETE /v1/private/user/listen-key
```

Fecha a listenKeyespecificada.

<h2 id="account-change-logs">
  Registros de Alteração de Conta
</h2>

```http
GET /v1/private/user/account-change-log?assetType=USDT&page=1&pageSize=20
```

Parâmetros da solicitação:

| Parâmetro    | Tipo   | Obrigatório | Descrição                     |
| ------------ | ------ | ----------- | ----------------------------- |
| `assetType`  | string | Não         | Tipo de ativo, como `USDT`    |
| `changeType` | string | Não         | Mudança de tipo               |
| `startTime`  | int64  | Não         | Horário de início             |
| `endTime`    | int64  | Não         | Fim dos tempos                |
| `page`       | int32  | Não         | Número da página, `1` padrão  |
| `pageSize`   | int32  | Não         | Itens por página, padrão `20` |

Campos de resposta:

| Campo                        | Tipo   | Descrição                        |
| ---------------------------- | ------ | -------------------------------- |
| `list[].assetType`           | string | Tipo de ativo                    |
| `list[].amount`              | string | Valor alterado                   |
| `list[].walletBalanceBefore` | string | Saldo da carteira antes da troca |
| `list[].walletBalanceAfter`  | string | Saldo da carteira após a troca   |
| `list[].frozenBalanceBefore` | string | Saldo congelado antes da troca   |
| `list[].frozenBalanceAfter`  | string | Saldo congelado após a troca     |
| `list[].changeType`          | string | Mudança de tipo                  |
| `list[].referenceId`         | string | ID de negócio relacionado        |
| `list[].createdAt`           | int64  | Tempo de criação                 |
| `total`                      | int64  | Contagem total                   |

<h2 id="30-day-volume-statistics">
  Estatísticas de Volume de 30 Dias
</h2>

```http
GET /v1/private/user/volume-stats
```

Campos de resposta:

| Campo         | Tipo   | Descrição                                          |
| ------------- | ------ | -------------------------------------------------- |
| `volume30d`   | string | Volume acumulado de negociação nos últimos 30 dias |
| `feeTotal30d` | string | Taxas acumuladas nos últimos 30 dias               |

<h2 id="balance-history">
  Histórico de Balanço
</h2>

```http
GET /v1/private/user/balance-history?period=1D&limit=30
```

Parâmetros da solicitação:

| Parâmetro | Tipo   | Obrigatório | Descrição                               |
| --------- | ------ | ----------- | --------------------------------------- |
| `period`  | string | Sim         | `1D` / `1W` / `1M`                      |
| `limit`   | int    | Não         | Número de itens devolvidos, padrão `30` |

Campos de resposta:

| Campo             | Tipo   | Descrição                   |
| ----------------- | ------ | --------------------------- |
| `items[].date`    | string | Data de agregação           |
| `items[].balance` | string | Saldo da carteira           |
| `items[].pnl`     | string | Realizou PnL para o período |

<h2 id="trade-overview">
  Visão Geral do Comércio
</h2>

```http
GET /v1/private/user/trade-overview?type=1M
```

Parâmetros da solicitação:

| Parâmetro | Tipo   | Obrigatório | Descrição                                              |
| --------- | ------ | ----------- | ------------------------------------------------------ |
| `type`    | string | Sim         | Faixa de tendência: `1D`, `1W`, `1M`, `3M`, `6M`, `1Y` |

Campos de resposta:

| Campo                | Tipo   | Descrição                                                        |
| -------------------- | ------ | ---------------------------------------------------------------- |
| `todayPnl`           | string | O PnL realizado de hoje                                          |
| `todayVolume`        | string | Volume de negociação de contratos de hoje                        |
| `totalVolume`        | string | Volume acumulado de negociação de contratos                      |
| `totalPnl`           | string | PnL realizado cumulativo                                         |
| `maxDrawdown30d`     | string | Valor máximo de redução nos últimos 30 dias                      |
| `maxDrawdown30dRate` | string | Taxa máxima de redução nos últimos 30 dias, decimal de `0` a `1` |
| `transferIn`         | string | Fundos transferidos cumulativos                                  |
| `transferOut`        | string | Fundos transferidos cumulativos para fora                        |
| `items[]`            | array  | Dados de tendência de ativos                                     |

<h2 id="asset-overview-summary">
  Resumo da Visão Geral do Ativo
</h2>

```http
GET /v1/private/user/asset/overview/summary
```

Os campos de resposta são os mesmos que os campos de resumo de visão geral do comércio, excluindo `items[]`.

<h2 id="asset-overview-trend">
  Tendência de Visão Geral dos Ativos
</h2>

```http
GET /v1/private/user/asset/overview/trend?type=1M
```

Parâmetros da solicitação:

| Parâmetro | Tipo   | Obrigatório | Descrição                                              |
| --------- | ------ | ----------- | ------------------------------------------------------ |
| `type`    | string | Sim         | Faixa de tendência: `1D`, `1W`, `1M`, `3M`, `6M`, `1Y` |

Campos de resposta:

| Campo                  | Tipo   | Descrição                     |
| ---------------------- | ------ | ----------------------------- |
| `items[].snapshotTime` | int64  | Tempo de snapshot             |
| `items[].balance`      | string | Saldo da conta corrente       |
| `items[].pnl`          | string | PnL para o período atual      |
| `items[].pnlRate`      | string | Taxa PnL para o período atual |
| `items[].totalPnl`     | string | PnL Acumulado                 |

<h2 id="favorite-symbols">
  Símbolos Favoritos
</h2>

<h2 id="save">
  Salvar
</h2>

```http
POST /v1/private/user/favorite-symbols
Content-Type: application/json
```

Órgão do pedido:

```json
{
  "symbols": ["BTCUSDT", "ETHUSDT"]
}
```

<h2 id="query">
  Consulta
</h2>

```http
GET /v1/private/user/favorite-symbols
```

Campos de resposta:

| Campo     | Tipo   | Descrição                  |
| --------- | ------ | -------------------------- |
| `symbols` | fio\[] | Lista de símbolos favorita |

<h2 id="related-documentation">
  Documentação relacionada
</h2>

* [Canal de Usuário Privado](/pt-BR/developer-api/websocket/private-user-channel)
* [Autenticação](/pt-BR/developer-api/authentication)
* [Transferência de Ativos](/pt-BR/trading/getting-started/asset-transfer)
* [Códigos de Erro e Solução de Problemas](/pt-BR/developer-api/error-codes-and-troubleshooting)