# FENKI

FENKI builds deterministic, versioned, provenance-aware data artifacts for foundation models.

Available adapter:
- astrology: natal charts, current sky, natal transits, and bounded transit ranges

Formal API discovery and schemas: https://fenki.net/openapi.json
Published FENKI Astrology GPT: https://chatgpt.com/g/g-6a7c81eb0a0c8191bfa79ed0daab3ed3-fenki-astrology

Working linked request (Paris natal chart):
https://fenki.net/llm/astrology/natal/?date=1990-05-17&time=14%3A35&timezone=Europe%2FParis&latitude=48.8566&longitude=2.3522&label=Paris%2C%20France&format=json

Calling instructions:
- For a registered GPT Action, import https://fenki.net/openapi.json with no authentication. The four GET operations are public, read-only, and marked non-consequential.
- An ordinary browsing session does not register OpenAPI as callable tools. If its browser rejects a freshly composed query URL as 'unsafe to open', first open https://fenki.net and follow the visible working API example, or use embed=base64. This is a browser trust policy, not an API error.
- For natal calculations, send date and time plus either a place name (place=...) or explicit coordinates with an IANA timezone (latitude=..., longitude=..., timezone=...); provide one or the other, never both.
- Transit sequence: first call calculateAstrologyNatalChart with format=json, then copy the exact data.chartRef from that response into the chart parameter of calculateAstrologyNatalTransits or calculateAstrologyTransitRange. Never pass a whole URL, JSON artifact, or constructed value. Treat chartRef as sensitive because it contains natal input.
- For interpretation, call natal or transits with format=json first. If the user requests an exact chart image, call embedAstrologyNatalChart or embedAstrologyTransitChart; these return application/json with an imageUrl (present as a markdown image) plus compact base64 SVG data, so the chat never opens a fresh URL, consumes a binary body, or exceeds response limits. format=png and format=svg remain for compatibility.

Do not recalculate astronomical positions, houses, aspects, exact observation times, applying status, or orbs when FENKI supplies them. Do not ask an image model to reconstruct chart geometry. Treat calculated source data and provenance as authoritative inputs, and keep them distinct from interpretation.