### How to Get Your API Key

1. Visit **https://masterswarm.net** and purchase a plan:
   - Explorer (€9.99) — 5 reports
   - Professional (€29.99) — 20 reports
   - Enterprise (€79.99) — 60 reports
2. After purchase, Gumroad emails you a **license key**
3. Go to **https://masterswarm.net/app/** → click Upgrade → paste your license key → Activate
4. Your key is now active — use it as `MASTERSWARM_API_KEY`

### Data Handling & Privacy

- **API Host**: `api.neurodoc.app` (operated by NeuroDoc Pro, same entity as masterswarm.net)
- **Servers**: Hetzner, Germany (EU-only)
- **Encryption**: TLS 1.3 end-to-end
- **Data Retention**: Zero — documents are processed in real-time and immediately discarded
- **GDPR**: Compliant — privacy policy at https://masterswarm.net (footer → Privacy Policy)
- **No data is stored, logged, or used for training**

## How To Use

### Single Engine Analysis

**Replace:**
- `MASTERSWARM_API_KEY` — your personal API key
- `ENGINE_ID` — one from the table above (e.g. `apex`, `chef`, `research`)
- `USER_QUESTION_OR_DOCUMENT_TEXT` — the user's question or extracted document text

### Engine Selection Guide

| User Request | Engine ID |
|---|---|
| Recipe, food, restaurant, menu | `chef` |
| Business strategy, startup, ROI | `apex` |
| SWOT, consulting, roadmap, KPIs | `consult` |
| Research, science, papers, evidence | `research` |
| Market analysis, competition, pricing | `market` |
| Crypto, trading, DeFi, portfolio | `apex` |
| Medical labs, blood tests, health | `research` |
| Legal, contracts, compliance | `consult` |
| Financial analysis, P&L, ratios | `apex` |
| General or multi-domain question | `assembly` |
| Data, statistics, anomalies | `analyst` |
| Molecular gastronomy, food science | `molecular` |
| Forecasting, predictions | `oracle` |

### Multi-Engine Analysis

For comprehensive reports, call multiple engines sequentially:

curl -s --max-time 120 -X POST https://api.neurodoc.app/aetherlang/execute \
  -H "Content-Type: application/json" \
  -H "X-Aether-Key: MASTERSWARM_API_KEY" \
  -d '{
    "code": "flow Q {\n  using target \"neuroaether\" version \">=0.2\";\n  input text query;\n  node G: guard mode=\"STANDARD\";\n  node E: ENGINE_ID style=\"professional\";\n  G -> E;\n  output text result from E;\n}",
    "query": "USER_QUESTION_OR_DOCUMENT_TEXT"
  }'

# Example: Run apex + consult + research on the same query
for ENGINE_ID in apex consult research; do
  curl -s --max-time 120 -X POST https://api.neurodoc.app/aetherlang/execute \
    -H "Content-Type: application/json" \
    -H "X-Aether-Key: MASTERSWARM_API_KEY" \
    -d "{
      \"code\": \"flow M {\n  using target \\\"neuroaether\\\" version \\\">=0.2\\\";\n  input text query;\n  node G: guard mode=\\\"STANDARD\\\";\n  node E: $ENGINE_ID style=\\\"professional\\\";\n  G -> E;\n  output text result from E;\n}\",
      \"query\": \"USER_QUESTION\"
    }"
done

{
  "status": "success",
  "result": {
    "final_output": "## Full analysis report in markdown...",
    "outputs": {"E": "..."},
    "execution_log": [
      {"node": "G", "status": "OK"},
      {"node": "E", "status": "OK", "duration": 5.2}
    ]
  },
  "duration_seconds": 6.1
}