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

# Get Lookers

## 📖 Descrição

Este endpoint retorna todos os lookers de um usuário, filtrados pelo email.

***

## 🛠️ Requisição

### Método

`GET`

### URL

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

### Parâmetros de Query

| Parâmetro | Tipo   | Obrigatório | Descrição        |
| --------- | ------ | ----------- | ---------------- |
| `email`   | string | Sim         | Email do usuário |

### Exemplo de Requisição

```bash theme={null}
curl -X GET "http://localhost:8080/v1/lookers?email=user@example.com"
```

### Exemplo de Resposta (200 OK)

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

***

## 📝 Códigos de Resposta

<Callout type="info">
  **200 OK**: Lista de lookers retornada com sucesso
</Callout>

<Callout type="warning">
  **400 Bad Request**: `email parameter is required` - Parâmetro email não fornecido
</Callout>

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

***

## 🔍 Notas

* Retorna um array vazio `[]` se o usuário não possuir lookers
* A resposta é ordenada por timestamp (mais recente primeiro)