Horoscope & AI Interpretations API

10 AI endpoints - part of the 700+ endpoint AstroWay platform (16 categories). 5 for horoscopes (daily, weekly, monthly, yearly, compatibility) and 5 for interpretations (natal, synastry, transits, element, placement). All built on real Swiss Ephemeris calculations (the same engine that powers Solar Fire and Astrodienst) - not on templates and not on raw LLM hallucinations.

How it works

1. The API calculates a real astrological chart (transits, natal, synastry) via Swiss Ephemeris
2. The result is passed through our AI gateway sitting on top of several leading LLM providers with an astrology system prompt and automatic failover
3. The LLM generates text with built-in safety guardrails (no medical/legal/financial advice)
4. Response includes a disclaimer and audit trail

Tip

AI endpoints return both calculations and text. You can use just the calculations (cheaper endpoints) and generate text with your own LLM.

Horoscope endpoints

Endpoint	Credits	What it generates
/v1/horoscope/daily	50	Daily horoscope based on current transits
/v1/horoscope/weekly	50	Weekly overview
/v1/horoscope/monthly	50	Monthly forecast
/v1/horoscope/yearly	100	Annual forecast
/v1/horoscope/compatibility	50	Text compatibility analysis

Interpretation endpoints

Endpoint	Credits	What it interprets
/v1/interpret/natal	100	Full natal chart interpretation
/v1/interpret/synastry	100	Synastry interpretation
/v1/interpret/transits	100	Current transit interpretation
/v1/interpret/element	100	Single element (planet in sign, aspect)
/v1/interpret/placement	100	Placement (planet in house)

Example

cURL

curl -X POST https://api.astroway.info/v1/horoscope/daily \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "sign": "cancer",
    "date": "2026-08-17",
    "language": "uk"
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/horoscope/daily', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    sign: 'cancer',
    date: '2026-08-17',
    language: 'uk',
  }),
});
const { data: horoscope } = await r.json();
console.log(horoscope.horoscope);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/horoscope/daily',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'sign': 'cancer',
        'date': '2026-08-17',
        'language': 'uk',
    },
)
horoscope = r.json()['data']
print(horoscope['horoscope'])

PHP

<?php
use GuzzleHttp\Client;

$aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $aw->post('horoscope/daily', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'sign' => 'cancer',
        'date' => '2026-08-17',
        'language' => 'uk',
    ],
]);
$horoscope = json_decode($r->getBody(), true)['data'];
echo $horoscope['horoscope'];

Safety guardrails

All AI endpoints have built-in protections:

• System prompt explicitly forbidding medical, legal, and financial advice
• Auto-injected disclaimer in every response
• Content filter: post-filtering on keywords
• Audit trail: logging of prompts and responses (90-day retention)
• disclaimer_inline: true: parameter for enterprise wanting disclaimer in the text body

Caution

AI interpretations are intended for entertainment. They do not replace consultation with a professional astrologer, doctor, lawyer, or financial advisor.

Who uses this

• Content platforms: daily horoscopes for an audience
• Astrology apps: personalized interpretations instead of generic text
• AI agents: via MCP server or direct API call
• Media: astrology content generated from real data

Pricing

Daily horoscope (/v1/horoscope/daily) - 50 credits. Full natal chart interpretation (/v1/interpret/natal) - 100 credits. On the Free tier that is 200 daily horoscopes or 100 interpretations per month.

Quick start → First request in 5 minutes

AI agents & MCP Integration with Claude, ChatGPT

Pricing From Free to Enterprise