# Stellaforge — birth-chart poster API (print quality)

Stellaforge is a **print-ready natal chart poster**: a single `POST /v1/reports/stellaforge` call returns a high-detail A4 poster. No AI — a fully deterministic render on Swiss Ephemeris, suitable for print-on-demand.

## What's on the poster

- **A professional-grade wheel** — colored element sectors, colored sign glyphs, degree labels on planets and cusps, an ASC arrow, an MC marker, roman/arabic house numbers, aspect lines with stroke scaled by orb
- **The big three** — Sun · Moon · Rising
- **A placements table** — sign + degree + house
- **Element and modality balance** — Fire/Earth/Air/Water + Cardinal/Fixed/Mutable bars
- **Key aspects** — the most influential, with glyphs

## 3 styles

| `style` | Description |
|---|---|
| `editorial` | Light, cream paper + pastel sectors (default) |
| `celestial` | Deep navy + gold — a premium boutique look |
| `classic` | Minimal black-and-white, arabic numbers, dashed cusps |

## Endpoint

| Endpoint | Method | Credits | Purpose |
|---|---|---|---|
| `/v1/reports/stellaforge` | POST | Tier 7 | Natal chart poster — **PDF** (default) or **HTML** (`?format=html`) |

## Example

```bash
curl -X POST https://api.astroway.info/v1/reports/stellaforge \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "chart": { "name": "Ada Lovelace", "date": "1815-12-10",
        "time": "18:00:00", "city": "London" },
        "style": "celestial", "language": "en" }'
# → { "url": "https://api.astroway.info/reports/…-stellaforge.pdf", "page_count": 1, "expires_at": "…" }
# (?format=html returns HTML directly)
```

Supports **white-label** (logo/colours/font) for account-bound keys, and **multi-language** output via `language`.

<Aside type="note">
`style` is read from the request **body**, not the query string. The poster is fully deterministic (0 AI) — identical input yields a byte-identical result, which matters for a print run.
</Aside>