Skip to content

Declinations​

POST
/api/calc/declination

Declinations, parallels and out-of-bounds flags for one moment.

A horoscope is a projection onto the ecliptic, and that projection throws away the north-south
axis. Two bodies with no zodiacal aspect between them can share a declination — a parallel,
which behaves like a conjunction. The same distance from the equator on opposite sides is a
contraparallel, which behaves like an opposition. Both are measured with a much tighter orb
than a longitude aspect; 1° is the convention and the default.

Out of bounds is a body past the Sun's own maximum declination. The Moon is out of bounds a
few days a month around a major lunar standstill; Mercury, Venus, Mars and Pluto go there at
intervals. The flag is judged against the true obliquity of the requested date, which is returned
alongside it as obliquity.

Authorizations​

ApiKeyAuth

API key for authentication. Get your API key from the dashboard.

Type
API Key (header: X-Api-Key)

Request Body​

application/json
JSON
{
  
"dateTime": "string",
  
"location": {
  
  
"longitude": 0,
  
  
"latitude": 0,
  
  
"timezone": "string"
  
},
  
"points": [
  
  
"string"
  
],
  
"orb": 1,
  
"moonCenter": "topocentric",
  
"language": "en",
  
"includeText": false,
  
"includeReadableEntities": false
}

Responses​

Declinations, parallels and out-of-bounds flags

application/vnd.api+json
JSON
{
  
"data": {
  
  
"dateTime": "string",
  
  
"points": {
  
  
  
"additionalProperties": {
  
  
  
  
"pointId": "string",
  
  
  
  
"declination": 0,
  
  
  
  
"declinationDms": [
  
  
  
  
  
0
  
  
  
  
],
  
  
  
  
"rightAscension": 0,
  
  
  
  
"latitude": 0,
  
  
  
  
"speedDeclination": 0,
  
  
  
  
"outOfBounds": true,
  
  
  
  
"hemisphere": "string"
  
  
  
}
  
  
},
  
  
"aspects": [
  
  
  
{
  
  
  
  
"pointA": "string",
  
  
  
  
"pointB": "string",
  
  
  
  
"aspect": "string",
  
  
  
  
"orb": 0,
  
  
  
  
"applying": true,
  
  
  
  
"declinationA": 0,
  
  
  
  
"declinationB": 0,
  
  
  
  
"text": "string"
  
  
  
}
  
  
],
  
  
"extremes": {
  
  
  
"northernmost": "string",
  
  
  
"southernmost": "string",
  
  
  
"outOfBoundsCount": 0
  
  
},
  
  
"obliquity": 0
  
}
}

Playground​

Authorization
Body

Samples​

Powered by VitePress OpenAPI

AstroAPI Documentation