> ## 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 Favorite Crypto

## 📖 Descrição

Este endpoint permite criar uma nova criptomoeda favorita para um usuário, vinculando o email ao ticker da criptomoeda.

***

## 🛠️ Requisição

### Método

`POST`

### URL

```plaintext theme={null}
/v1/favorite-cryptos
```

### Request Body

| Campo    | Tipo   | Obrigatório | Descrição                                    |
| -------- | ------ | ----------- | -------------------------------------------- |
| `email`  | string | Sim         | Email do usuário                             |
| `ticker` | string | Sim         | Ticker da criptomoeda (ex: BTCUSDT, ETHUSDT) |

### Exemplo de Requisição

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

### Exemplo de Resposta (201 Created)

```json theme={null}
{
  "id": "507f1f77bcf86cd799439011",
  "email": "user@example.com",
  "ticker": "BTCUSDT",
  "timestamp": 1234567890000
}
```

***

## 📝 Códigos de Resposta

<Callout type="info">
  **201 Created**: Crypto favorita criada 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
  * `ticker is required`: Ticker não fornecido
</Callout>

<Callout type="error">
  **409 Conflict**: `favorite crypto already exists` - A combinação email+ticker já existe
</Callout>

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

***

## 🔍 Notas

* A combinação email + ticker deve ser única
* Um usuário pode ter múltiplas cryptos favoritas
* Não há limite de cryptos favoritas por usuário