ephemeris

Calculate Draconic Chart

Calculates draconic chart with True Node as 0 Aries.

post/ephemeris/draconic

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/ephemeris/draconic
  • Auth: one of:
    • HTTP bearer
    • API key in header X-OpenEphemeris-API-Key
    • API key in header X-API-Key
    • API key in header X-Service-Key

Request body

body_idsinteger[]

Optional list of body IDs to compute in the draconic frame. Omit to use the default set [0-11, 15-20] (Sun–Pluto, both North Nodes, Chiron, Pholus and the four main asteroids). Supported extras include -1 (South Node, Mean), -3 (South Node, True), 12/13/40 (Lilith variants) and 21/22 (Vertex / Anti-Vertex, which require subject.birth_location). An unsupported ID is rejected with 422 rather than silently dropped; the set actually computed is echoed in metadata.body_ids.

format'json' | 'llm'

Response format: json | llm.

include_visualboolean

If true, also render the draconic chart wheel (every longitude, cusp and angle rotated so the North Node is 0° Aries) as SVG or PNG. Visuals incur a +2 credit surcharge.

Example request

{
  "subject": {
    "birth_datetime": {
      "iso": "1990-06-15T14:30:00"
    },
    "birth_location": {
      "latitude": {
        "decimal": 40.7128
      },
      "longitude": {
        "decimal": -74.006
      },
      "timezone": {
        "iana_name": "America/New_York"
      }
    },
    "name": "John Doe"
  }
}

Response

Successful Response

metadataobject
successboolean

Changes

No recorded changes to this operation across all 1 revision of this API.