> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arbitragem-crypto.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Looker

## 📖 Descrição

Este endpoint permite criar um novo looker (lista de monitoramento de criptomoedas) para um usuário. Cada looker pode ter um nome personalizado e conter até 6 criptomoedas.

***

## 🛠️ Requisição

### Método

`POST`

### URL

```plaintext theme={null}
/v1/lookers
```

### Request Body

| Campo     | Tipo            | Obrigatório | Descrição                                   |
| --------- | --------------- | ----------- | ------------------------------------------- |
| `email`   | string          | Sim         | Email do usuário                            |
| `name`    | string          | Não         | Nome do looker                              |
| `cryptos` | array de string | Não         | Lista de tickers de criptomoedas (máximo 6) |

### Validações

* Email é obrigatório
* Nome e cryptos são opcionais
* Máximo de 6 cryptos por looker

### Exemplo de Requisição (completo)

```bash theme={null}
curl -X POST http://localhost:8080/v1/lookers \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "name": "My Portfolio",
    "cryptos": ["BTCUSDT", "ETHUSDT", "ADAUSDT"]
  }'
```

### Exemplo de Requisição (mínimo - apenas email)

```bash theme={null}
curl -X POST http://localhost:8080/v1/lookers \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com"
  }'
```

### Exemplo de Resposta (201 Created)

```json theme={null}
{
  "id": "507f1f77bcf86cd799439011",
  "email": "user@example.com",
  "name": "My Portfolio",
  "cryptos": ["BTCUSDT", "ETHUSDT", "ADAUSDT"],
  "timestamp": 1234567890000
}
```

***

## 📝 Códigos de Resposta

<Callout type="info">
  **201 Created**: Looker criado com sucesso
</Callout>

<Callout type="warning">
  **400 Bad Request**:

  * `Invalid request body`: Corpo da requisição inválido
  * `email is required`: Email não fornecido
  * `maximum 6 cryptos allowed`: Mais de 6 cryptos fornecidas
</Callout>

<Callout type="error">
  **500 Internal Server Error**: `Failed to create looker` - Erro interno do servidor
</Callout>

***

## 🔍 Notas

* Um usuário pode ter múltiplos lookers
* Cada looker pode ter no máximo 6 cryptos
* Email é obrigatório na criação, nome e cryptos são opcionais
* O ID do looker é um ObjectID do MongoDB gerado automaticamente