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 astronomical calculations, accurate to the arc-second - not on templates and not on raw LLM hallucinations.

How it works

1. The API calculates a real astrological chart (transits, natal, synastry) at arc-second precision
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

Plain style for consumer apps

The default text explains itself in astrology: it names the planets, houses and aspects behind each point. For a dating app, a news feed or anything read by people who never asked for a chart, send style: "plain" to the daily, weekly or monthly horoscope:

{ "sign": "leo", "language": "ro", "style": "plain", "length": "short", "topics": ["love", "advice"] }

• No astrology terms. Mood, people, work, body and money in everyday words. The English text is checked for planet names, houses, transits and the like, rewritten once if any slipped in, and never cached while one remains.
• The same meaning in every language. The text is written once in English for the sign and date and translated from that, so a Romanian and a Russian reader get the same day, not two separate readings.
• length: short (about 70-110 words a day) or medium (default, about 150-230).
• topics: any of overview, love, career, health, finance, advice, returned in that order in sections and horoscope. Also works with the default style.

A plain answer leaves out transits, aspects and the other computed fields: they are the astro reading’s evidence. Same price as the default.

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