Codex API

Calculate first. Narrate second.

A chart engine for apps and agents. Every paid call is authenticated, returns a traceable JSON envelope, and is billed against your plan.

Base path

/api/v1

Auth

x-api-key

Envelope

request_id · calculated_at · result

First request

curl -X POST https://your-domain.com/api/v1/natal \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"latitude":40.7128,"longitude":-74.006}'

Choose a family

Charts

Natal, transits, synastry, composite, Davison, Draconic, heliocentric, houses, aspects.

Sky

Moon, planets, ephemeris, eclipses, void of course, asteroids, 43 fixed stars.

Timing

Returns, progressions, solar arc, profections, zodiacal releasing, firdaria.

Traditions

Vedic, BaZi, Tzolkin, Arabic parts, Uranian, and Huber — calculation layers before any reading.

Agents

JSON-RPC MCP tools plus REST batch, usage, timezone, and geocoding.

Access

Header-only keys, plan quotas, and the public routes that do not need a key.