Chart Interpretation API

Deterministic astrological interpretation signals for real applications.

The AstroAPI Chart Interpretation endpoint emits structured, machine-readable astrological signals grounded in Hellenistic and Western tradition. It is designed for systems that need consistent classification and semantic markers — without generated prose, prompts, or language models.

What This API Provides

• Deterministic interpretation signals
• Transit-aware classification
• Semantic themes and intensity markers
• Stable interpretation keys for indexing and analytics
• JSON output designed for downstream composition

Interpretation Responsibility

AstroAPI does not perform full narrative synthesis or subjective chart reading. Instead, it provides discrete interpretation signals derived from classical astrological logic.

Client applications define how these signals are weighted, combined, rendered, or monetized. This allows complete control over interpretive philosophy, tone, and presentation while preserving deterministic output.

Astrological Framework

Signal generation is derived from classical Hellenistic astrology (planetary condition, aspects, houses, rulerships, sect) combined with modern Western interpretive synthesis. Meaning is encoded as stable semantic identifiers rather than narrative text.

Endpoint

POST https://api.astroapi.io/horoscope

Authenticate using Authorization: Bearer <API_KEY>. Designed for backend-safe, server-to-server usage.

Required Request Fields

• birth.date — ISO date (YYYY-MM-DD)
• birth.time — 24-hour time (HH:MM)
• birth.lat — latitude (decimal)
• birth.lon — longitude (decimal)

Example Response

{
  "type": "transit-aware-horoscope",
  "tradition": ["hellenistic", "western"],
  "summary": {
    "overall_tone": "mixed",
    "intensity": 0.42
  },
  "transits": [
    {
      "planet": "Saturn",
      "aspect": "Square",
      "natal_point": "Sun",
      "house": 10,
      "themes": ["career", "authority"],
      "interpretation_key": "saturn_square_sun"
    }
  ]
}

Quick Test / curl

curl https://api.astroapi.io/api/astro/horoscope \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "birth": {
      "date": "2000-01-01",
      "time": "12:00",
      "lat": 33.7488,
      "lon": -84.3877
    }
  }'

Common Uses

• Chart visualization and interpretation layers
• Professional astrology and research platforms
• Classification, tagging, and analytics pipelines
• SaaS tools without editorial content debt
• Experimental or opinionated astrology systems

AstroAPI provides interpretation infrastructure — structured signals that can be composed, rendered, and extended downstream.

// JavaScript — Chart Interpretation Example
fetch("https://api.astroapi.io/horoscope", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    birth: {
      date: "2000-01-01",
      time: "12:00",
      lat: 0.0,
      lon: 0.0
    }
  })
})
  .then(res => res.json())
  .then(data => console.log(data));

# Python — Chart Interpretation Example
import requests

url = "https://api.astroapi.io/horoscope"

payload = {
    "birth": {
        "date": "2000-01-01",
        "time": "12:00",
        "lat": 0.0,
        "lon": 0.0
    }
}

headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())