ephemeris

Calculate relocation chart

Return angles, house cusps, and planet house changes for a relocated chart. 🤖 AI-optimized output available — add format=llm to reduce payload ~55%.

post/ephemeris/relocation

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/ephemeris/relocation
  • 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

formatstring nullable

Response format: json | llm.

Headers

authorizationstring nullable
X-API-Keystring nullable
X-OpenEphemeris-API-Keystring nullable
apikeystring nullable

Request body

house_system'P' | 'K' | 'O' | 'R' | 'C' | 'E' | 'W'

Supported house systems.

include_visualboolean

If true, also render the relocated chart wheel (natal planets in the relocated houses) as SVG or PNG. Visuals incur a +2 credit surcharge.

natal_idstring

Reserved identifier for previously computed natal context (lookup support depends on deployment configuration)

relocation_latnumber required

Relocation latitude in decimal degrees

relocation_lonnumber required

Relocation longitude in decimal degrees

Example request

{
  "house_system": "P",
  "natal": {
    "subject": {
      "birth_datetime": {
        "iso": "1990-01-01T12:00:00Z"
      },
      "birth_location": {
        "latitude": {
          "decimal": 34.0522
        },
        "longitude": {
          "decimal": -118.2437
        },
        "timezone": {
          "iana_name": "America/Los_Angeles"
        }
      },
      "name": "Relocation Client"
    }
  },
  "relocation_lat": 40.7128,
  "relocation_lon": -74.006
}

Response

Successful Response

planetsobject

Planetary positions keyed by body name, matching natal chart format

successboolean

Indicates relocation succeeded

Example response

{
  "angles": {
    "asc": {
      "longitude": 123.45,
      "sign": "Leo",
      "sign_longitude": 3.45,
      "sign_symbol": "Leo"
    },
    "dsc": {
      "longitude": 303.45,
      "sign": "Aquarius",
      "sign_longitude": 3.45,
      "sign_symbol": "Aquarius"
    },
    "ic": {
      "longitude": 30.1,
      "sign": "Taurus",
      "sign_longitude": 0.1,
      "sign_symbol": "Taurus"
    },
    "mc": {
      "longitude": 210.1,
      "sign": "Scorpio",
      "sign_longitude": 0.1,
      "sign_symbol": "Scorpio"
    }
  },
  "calculation_metadata": {
    "coordinate_system": "geocentric",
    "ephemeris_source": "SuperNOVAS / Calceph",
    "zodiac_type": "tropical"
  },
  "houses": [
    {
      "index": 1,
      "longitude": 123.45,
      "sign": "Leo",
      "sign_longitude": 3.45,
      "size": 30
    },
    {
      "index": 2,
      "longitude": 153.45,
      "sign": "Virgo",
      "sign_longitude": 3.45,
      "size": 28.7
    }
  ],
  "metadata": {
    "calculation_source": "SuperNOVAS / Calceph",
    "house_system": "P",
    "natal_house_system": "P",
    "observer_location": {
      "latitude": 40.7128,
      "longitude": -74.006
    },
    "reference_frame": "geocentric_ecliptic_J2000",
    "requested_house_system": "P",
    "time_system": "UTC",
    "topocentric_flag": false
  },
  "planet_house_changes": [
    {
      "body": "Sun",
      "from_house": 10,
      "to_house": 9
    },
    {
      "body": "Venus",
      "from_house": 7,
      "to_house": 8
    }
  ],
  "success": true,
  "summary": {
    "changed_houses": 12,
    "changed_planets": 2,
    "notes": "Relocated using Placidus; planetary longitudes unchanged."
  }
}

Changes

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