predictive

Calculate transit chart (full chart snapshot)

Return a full chart payload for a given moment (transit chart). Includes all supported bodies: Sun–Pluto (core) plus Chiron, Mean/True North & South Nodes, Mean/True Lilith (Black Moon), and Ceres (extended bodies — gracefully omitted when ephemeris kernels are unavailable). Also returns houses/angles, aspects (major; minor opt-in), and a body_categories map for UI rendering. This is a chart snapshot endpoint (not a transit event search). 🤖 AI-optimized output: add format=llm to reduce payload ~70%.

post/predictive/transit-chart

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/predictive/transit-chart
  • 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

Query parameters

output_modestring nullable

Deprecated: use preset+format. Accepts full|simple|llm.

formatstring

Response format: json | llm. Controls response projection only.

Request body

include_all_traditional_partsboolean

DEPRECATED. Prefer request body options.include_all_traditional_parts where applicable. This top-level field is accepted for backward compatibility and may be removed in a future release.

include_aspectsboolean

DEPRECATED. Prefer request body options.include_aspects. This field is accepted for backward compatibility and may be removed in a future release.

include_dignitiesboolean

DEPRECATED. Prefer request body options.include_dignities. This top-level field is accepted for backward compatibility and may be removed in a future release.

include_hermetic_lotsboolean

DEPRECATED. Prefer request body enhanced_options.include_hermetic_lots (or options.include_hermetic_lots). This top-level field is accepted for backward compatibility and may be removed in a future release.

include_visualboolean nullable

When true, a high-fidelity chart wheel SVG/PNG is embedded in the response alongside the data payload. Adds 2 credits to the request cost.

Example request

{
  "configuration": {
    "ayanamsa": "lahiri",
    "coordinate_frame": "equatorial",
    "coordinate_system": "topocentric",
    "house_system": "W",
    "object_set": "asteroids_major",
    "zodiac_type": "sidereal"
  },
  "subject": {
    "birth_datetime": {
      "iso": "1985-03-20T08:15:00"
    },
    "birth_location": {
      "latitude": {
        "decimal": 37.7749
      },
      "longitude": {
        "decimal": -122.4194
      },
      "timezone": {
        "iana_name": "America/Los_Angeles"
      }
    },
    "name": "Jane Smith"
  }
}

Response

Successful Response

output_modestring

Output projection mode (full | simple | llm)

schema_versionstring

Schema version for the selected output mode (e.g., full_v1, simple_v1, llm)

successboolean

Response success status

Example response

{
  "data": {
    "calculation_metadata": {
      "technique_id": "natal",
      "technique_label": "Composite (Davison)",
      "technique_method": "davidson",
      "technique_version": "v1"
    }
  }
}

Changes

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