GET /v1/solar-proximity — Determine if planets are cazimi, combust, under the beams, or free from the Sun.

Solar Proximity

Determine each planet's proximity to the Sun: cazimi (within 0°17'), combust (within 8°), under the beams (within 17°), or free.

Text

GET  /v1/solar-proximity
POST /v1/solar-proximity

Credit cost: 1

Parameters

Parameter	Type	Required	Default	Description
`datetime`	string	One of `datetime` or `jd`	—	ISO 8601 UTC datetime
`jd`	number	One of `datetime` or `jd`	—	Julian Day in UT1
`bodies`	string	No	`"planets"`	Comma-separated body names

No location is required — solar proximity depends only on ecliptic longitude separation.

Status thresholds

Status	Separation	Traditional meaning
`cazimi`	< 0°17'	In the heart of the Sun — extremely powerful
`combust`	< 8°	Weakened, overpowered by the Sun's light
`under_the_beams`	< 17°	Diminished but not fully overwhelmed
`free`	>= 17°	Free from solar influence

The Sun itself is excluded from the results (it cannot be proximate to itself).

Response

JSON

{
  "data": {
    "proximity": [
      {
        "body": "mercury",
        "separation": 3.21,
        "status": "combust"
      },
      {
        "body": "venus",
        "separation": 25.4,
        "status": "free"
      }
    ]
  },
  "meta": {
    "credits_used": 1,
    "..."
  }
}

Each record includes:

body — Planet name
separation — Angular separation from the Sun in degrees
status — One of cazimi, combust, under_the_beams, or free

Examples

Current planetary combustion status

Bash

curl "https://api.morphemeris.com/v1/solar-proximity?\
datetime=2024-03-20T12:00:00Z" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

javascript

const res = await fetch(
  "https://api.morphemeris.com/v1/solar-proximity?" + new URLSearchParams({
    datetime: "2024-03-20T12:00:00Z",
  }),
  { headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const { data } = await res.json();

Python

import requests

res = requests.get(
    "https://api.morphemeris.com/v1/solar-proximity",
    params={"datetime": "2024-03-20T12:00:00Z"},
    headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()

Check specific planets

Bash

curl "https://api.morphemeris.com/v1/solar-proximity?\
datetime=2024-03-20T12:00:00Z&bodies=mercury,venus" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

javascript

const res = await fetch(
  "https://api.morphemeris.com/v1/solar-proximity?" + new URLSearchParams({
    datetime: "2024-03-20T12:00:00Z",
    bodies: "mercury,venus",
  }),
  { headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const { data } = await res.json();

Python

import requests

res = requests.get(
    "https://api.morphemeris.com/v1/solar-proximity",
    params={
        "datetime": "2024-03-20T12:00:00Z",
        "bodies": "mercury,venus",
    },
    headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()

Tips

Mercury is most frequently combust, spending roughly a third of its orbit within 8° of the Sun.
Cazimi is extremely rare — a planet is cazimi for only a few hours during each conjunction with the Sun. In traditional astrology, cazimi is considered a position of great strength, not weakness.
Solar proximity is a key consideration in horary astrology for determining whether a significator can "act" effectively.
The Moon is included in results but is typically only combust near a solar eclipse (New Moon).

Solar Proximity

On this page