Live Swagger (produção): https://investapi-fhu5.onrender.com/swagger/index.html

InvestAPI é uma API REST para gerenciamento de investimentos com foco em simplicidade. Ela entrega autenticação com JWT, cadastro e gestão de usuários, carteira de ativos, lançamentos de transações, atualização de cotações, dashboard consolidado, rate limiting global e health check para monitoramento.

As cotações externas vêm da Brapi para ações e da CoinGecko para criptomoedas.

• Autenticação com registro e login via JWT
• Carteira com ativos e transações
• Cotações externas com cache
• Dashboard com resumo, performance e alocação
• Rate limiting para proteger a API
• Health check para verificar disponibilidade

• .NET 10
• ASP.NET Core Web API
• Entity Framework Core
• SQLite
• JWT Bearer
• BCrypt.Net-Next
• FluentValidation
• Swagger/OpenAPI
• HttpClientFactory
• Rate Limiting do ASP.NET Core

Padrão: MVC com Repository Pattern (Layered Architecture)

HTTP Request
    ↓
Controllers (DTOs de entrada)
    ↓
Services (Lógica de negócio)
    ↓
Repositories / DbContext (Acesso a dados)
    ↓
Database

• Controllers — Endpoints HTTP, validação de entrada com FluentValidation
• Services — Lógica de negócio isolada (Auth, Portfolio, Cotações, etc)
• Repositories — Abstração de acesso a dados (Assets, Transactions)
• Models — Entidades do banco (Users, Assets, Transactions)
• DTOs — Transferência de dados entre client/server
• Data — Entity Framework Core + DbContext
• Middleware — Tratamento global de exceções
• Validators — Regras de validação de entrada

Este projeto usa uma arquitetura em camadas simples porque fica mais fácil de entender e manter. Os services acessam o DbContext e os repositories sem criar muitas abstrações extras. Para um projeto pequeno ou de portfólio, esse formato deixa o código mais direto.

Se o sistema crescer, aí vale separar melhor em use cases e camadas mais rígidas.

• .NET 10 SDK
• SQLite usa arquivo local no projeto; no Render, aponte para um disco persistente

1. Copie o arquivo de exemplo:

cp .env.example .env

2. Edite o arquivo .env com suas credenciais:

ConnectionStrings__DefaultConnection=Data Source=investapi.db
JwtSettings__SecretKey=sua_chave_secreta_com_minimo_32_bytes
QuoteSettings__BrapiToken=seu_token_da_brapi
Cors__AllowedOrigins=http://localhost:3000,http://localhost:5173

⚠️ Importante: Nunca commit o arquivo .env — ele está no .gitignore.

# Clone o repositório
git clone https://github.com/mapompeo/InvestAPI.git
cd InvestAPI

# Instale as dependências
dotnet restore

# Rode a aplicação
dotnet run

A API fica disponível nas portas definidas em InvestAPI/Properties/launchSettings.json e o Swagger aparece em /swagger.

Swagger pública: https://investapi-fhu5.onrender.com/swagger/index.html

• Use um serviço Web no Render com Docker.
• Deixe o Dockerfile na raiz do repositório.
• O container já usa a porta informada pelo Render.
• O SQLite fica em investapi.db dentro do container.
• Sem disco persistente, os dados do SQLite podem ser perdidos entre deploys.

GET /health
Accept: application/json

POST /api/v1/auth/login
Content-Type: application/json

{
  "email": "[email protected]",
  "password": "SenhaForte123!"
}

GET /api/v1/dashboard
Authorization: Bearer {seu-token}
Accept: application/json

Base path: /api/v1

🔒 = Requer autenticação (Bearer token)

POST /api/v1/auth/register
Content-Type: application/json

{
  "name": "João Silva",
  "email": "[email protected]",
  "password": "SenhaForte123!",
  "confirmPassword": "SenhaForte123!"
}

POST /api/v1/auth/login
Content-Type: application/json

{
  "email": "[email protected]",
  "password": "SenhaForte123!"
}

Response:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "email": "[email protected]",
  "name": "João Silva"
}

POST /api/v1/assets
Authorization: Bearer {seu-token}
Content-Type: application/json

{
  "ticker": "PETR4",
  "type": "Stock",
  "quantity": 100,
  "avgBuyPrice": 38.50
}

Response:

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "ticker": "PETR4",
  "currentPrice": 40.2,
  "totalInvested": 3850.0,
  "currentValue": 4020.0,
  "profitLoss": 170.0,
  "profitLossPercentage": 4.42
}

1. O usuário cria conta e faz login.
2. A API devolve um token JWT.
3. Com o token, o usuário cria ativos e transações.
4. A API calcula os dados da carteira e busca cotações externas.

• Swagger: Acesse /swagger quando a API estiver rodando

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

Matheus Pompeo