Naelos.ai

A complete natal (birth) chart: every planet's sign, degree and house, the Ascendant and Midheaven, retrogrades, and the aspects between planets with exact orbs. Calculated from NASA JPL data by Naelos Ephemeris.

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^[+-]?\\d{4,5}-\\d{2}-\\d{2}$",
      "description": "Birth date, YYYY-MM-DD"
    },
    "time": {
      "description": "Local clock time, HH:MM (24-hour). If unknown, omit: noon is used, and houses and angles are then unreliable.",
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$"
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Birthplace latitude in decimal degrees (north positive)"
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Birthplace longitude in decimal degrees (east positive)"
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone of the birthplace, e.g. America/New_York. Historical daylight saving is applied from it."
    },
    "place": {
      "description": "Birthplace name, echoed back so the user can check the coordinates",
      "type": "string",
      "maxLength": 120
    },
    "house_system": {
      "description": "House system (default placidus)",
      "type": "string",
      "enum": [
        "placidus",
        "whole_sign",
        "koch",
        "equal",
        "campanus",
        "regiomontanus",
        "porphyry",
        "meridian",
        "morinus"
      ]
    }
  },
  "required": [
    "date",
    "latitude",
    "longitude",
    "timezone"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Where every planet is at a moment (now by default): sign, degree, retrograde, and the aspects between them. Give a place to add houses and angles. Works for any date from 13,200 BC to AD 17,191.

{
  "type": "object",
  "properties": {
    "datetime_utc": {
      "description": "The moment in UTC, YYYY-MM-DDTHH:MM (default now)",
      "type": "string",
      "pattern": "^[+-]?\\d{4,5}-\\d{2}-\\d{2}T\\d{2}:\\d{2}"
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

One body's tropical position on a date, anywhere from 13,200 BC to AD 17,191, with its speed and whether it is retrograde. For historical and ancient dates; dates before 1582 are proleptic Gregorian.

{
  "type": "object",
  "properties": {
    "body": {
      "type": "string",
      "enum": [
        "sun",
        "moon",
        "mercury",
        "venus",
        "mars",
        "jupiter",
        "saturn",
        "uranus",
        "neptune",
        "pluto",
        "true_node",
        "chiron"
      ]
    },
    "date": {
      "type": "string",
      "pattern": "^[+-]?\\d{4,5}-\\d{2}-\\d{2}$"
    },
    "time_utc": {
      "description": "HH:MM UTC (default 12:00)",
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$"
    }
  },
  "required": [
    "body",
    "date"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Every exact transit of the planets (Sun to Pluto; the Moon is left out as it aspects everything monthly) to a birth chart's planets, Ascendant and Midheaven over a span, with the exact date of each and whether the planet is retrograde. Major aspects: conjunction, sextile, square, trine, opposition.

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^[+-]?\\d{4,5}-\\d{2}-\\d{2}$",
      "description": "Birth date, YYYY-MM-DD"
    },
    "time": {
      "description": "Local clock time, HH:MM (24-hour). If unknown, omit: noon is used, and houses and angles are then unreliable.",
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$"
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Birthplace latitude in decimal degrees (north positive)"
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Birthplace longitude in decimal degrees (east positive)"
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone of the birthplace, e.g. America/New_York. Historical daylight saving is applied from it."
    },
    "place": {
      "description": "Birthplace name, echoed back so the user can check the coordinates",
      "type": "string",
      "maxLength": 120
    },
    "from": {
      "description": "Start date (default today)",
      "type": "string",
      "pattern": "^[+-]?\\d{4,5}-\\d{2}-\\d{2}$"
    },
    "days": {
      "description": "Length of the span in days (default 30, at most 366)",
      "type": "integer",
      "minimum": 1,
      "maximum": 366
    }
  },
  "required": [
    "date",
    "latitude",
    "longitude",
    "timezone"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The aspects between two people's birth charts (each one's planets to the other's), with exact orbs and strength.

{
  "type": "object",
  "properties": {
    "person_a": {
      "type": "object",
      "properties": {
        "date": {
          "type": "string",
          "pattern": "^[+-]?\\d{4,5}-\\d{2}-\\d{2}$",
          "description": "Birth date, YYYY-MM-DD"
        },
        "time": {
          "description": "Local clock time, HH:MM (24-hour). If unknown, omit: noon is used, and houses and angles are then unreliable.",
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}$"
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "description": "Birthplace latitude in decimal degrees (north positive)"
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "description": "Birthplace longitude in decimal degrees (east positive)"
        },
        "timezone": {
          "type": "string",
          "description": "IANA time zone of the birthplace, e.g. America/New_York. Historical daylight saving is applied from it."
        },
        "place": {
          "description": "Birthplace name, echoed back so the user can check the coordinates",
          "type": "string",
          "maxLength": 120
        }
      },
      "required": [
        "date",
        "latitude",
        "longitude",
        "timezone"
      ],
      "description": "First person's birth data"
    },
    "person_b": {
      "type": "object",
      "properties": {
        "date": {
          "type": "string",
          "pattern": "^[+-]?\\d{4,5}-\\d{2}-\\d{2}$",
          "description": "Birth date, YYYY-MM-DD"
        },
        "time": {
          "description": "Local clock time, HH:MM (24-hour). If unknown, omit: noon is used, and houses and angles are then unreliable.",
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}$"
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "description": "Birthplace latitude in decimal degrees (north positive)"
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "description": "Birthplace longitude in decimal degrees (east positive)"
        },
        "timezone": {
          "type": "string",
          "description": "IANA time zone of the birthplace, e.g. America/New_York. Historical daylight saving is applied from it."
        },
        "place": {
          "description": "Birthplace name, echoed back so the user can check the coordinates",
          "type": "string",
          "maxLength": 120
        }
      },
      "required": [
        "date",
        "latitude",
        "longitude",
        "timezone"
      ],
      "description": "Second person's birth data"
    }
  },
  "required": [
    "person_a",
    "person_b"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The solar return for a year (the moment the Sun returns to its birth position, the chart for that year) or the lunar return nearest now, cast for the birthplace or another location.

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^[+-]?\\d{4,5}-\\d{2}-\\d{2}$",
      "description": "Birth date, YYYY-MM-DD"
    },
    "time": {
      "description": "Local clock time, HH:MM (24-hour). If unknown, omit: noon is used, and houses and angles are then unreliable.",
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$"
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Birthplace latitude in decimal degrees (north positive)"
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Birthplace longitude in decimal degrees (east positive)"
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone of the birthplace, e.g. America/New_York. Historical daylight saving is applied from it."
    },
    "place": {
      "description": "Birthplace name, echoed back so the user can check the coordinates",
      "type": "string",
      "maxLength": 120
    },
    "kind": {
      "type": "string",
      "enum": [
        "solar",
        "lunar"
      ]
    },
    "year": {
      "description": "Solar return year (default this year)",
      "type": "integer",
      "minimum": -13190,
      "maximum": 17180
    },
    "return_latitude": {
      "description": "Where the person is for the return, if not the birthplace",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "return_longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180
    }
  },
  "required": [
    "date",
    "latitude",
    "longitude",
    "timezone",
    "kind"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The progressed chart as of today: secondary progressions (a day after birth for each year of life) or solar arc directions (every point moved by the Sun's progressed arc).

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^[+-]?\\d{4,5}-\\d{2}-\\d{2}$",
      "description": "Birth date, YYYY-MM-DD"
    },
    "time": {
      "description": "Local clock time, HH:MM (24-hour). If unknown, omit: noon is used, and houses and angles are then unreliable.",
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$"
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Birthplace latitude in decimal degrees (north positive)"
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Birthplace longitude in decimal degrees (east positive)"
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone of the birthplace, e.g. America/New_York. Historical daylight saving is applied from it."
    },
    "place": {
      "description": "Birthplace name, echoed back so the user can check the coordinates",
      "type": "string",
      "maxLength": 120
    },
    "method": {
      "description": "Default secondary",
      "type": "string",
      "enum": [
        "secondary",
        "solar_arc"
      ]
    }
  },
  "required": [
    "date",
    "latitude",
    "longitude",
    "timezone"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Between two dates: planets changing sign, new and full Moons (and quarters), and retrograde and direct stations, each with its exact moment in UTC. At most two years per call.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^[+-]?\\d{4,5}-\\d{2}-\\d{2}$"
    },
    "to": {
      "type": "string",
      "pattern": "^[+-]?\\d{4,5}-\\d{2}-\\d{2}$"
    },
    "kinds": {
      "description": "Default all three",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "ingresses",
          "lunations",
          "stations"
        ]
      }
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Solar and lunar eclipses between two dates (up to 20 years per call), with type, the exact moment of greatest eclipse and the eclipse degree. Works across the full 15,000-year span.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^[+-]?\\d{4,5}-\\d{2}-\\d{2}$"
    },
    "to": {
      "type": "string",
      "pattern": "^[+-]?\\d{4,5}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Which national charts (198) and empire charts (19) Naelos holds, each researched and sourced, with the founding event it is cast for. The charts themselves, with their times, places and readings, are in Naelos's Mundane suite.

{
  "type": "object",
  "properties": {
    "search": {
      "description": "Filter by name, e.g. France",
      "type": "string",
      "maxLength": 60
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}