Horoscope API
Transit-based forecast with house activations
Get the daily horoscope for any zodiac sign. Forecast is generated from real-time planetary transits using whole-sign house positions, so every sign receives unique content. Returns love, career, health, finance, overview with active transits, Moon sign, Moon phase, energy rating, lucky number, lucky color, and compatible signs. Supports date parameter for editorial scheduling. Daily horoscope API, zodiac forecast, sun sign horoscope, astrology prediction.
Request
GET /api/v2/astrology/horoscope/{sign}/daily
Parameters
| Parameter | Type | Description |
|---|---|---|
| sign*path | string enum | Zodiac sign, case-insensitive (e.g., aries, Aries, ARIES all work). |
| langquery | string enum | Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English. Default en. |
| datequery | string (date) | Forecast date in YYYY-MM-DD format. Defaults to today. Supports future and past dates for editorial scheduling. |
Response
Structured JSON with documented fields, verified against NASA JPL Horizons across 828 gold-standard tests. Not hallucinated text.
{
"sign": "Aries",
"date": "2026-04-03",
"overview": "string",
"love": "string",
"career": "string",
"health": "string",
"finance": "string",
"advice": "string",
"luckyNumber": 7,
"luckyColor": "Gold",
"compatibleSigns": [
"Leo",
"Sagittarius",
"Gemini"
],
"activeTransits": [
"Moon in Libra (7th house of partnerships and relationships)",
"Venus in Taurus (2nd house of finances and personal values)"
],
"moonSign": "Libra",
"moonPhase": "Waxing Gibbous Moon",
"energyRating": 7
}Response fields
| Field | Type | Description |
|---|---|---|
| sign* | string | Zodiac sign for this horoscope. |
| date* | string | Date of this daily horoscope (YYYY-MM-DD). |
| overview* | string | General daily overview based on Moon house activation and planetary transits. Unique per sign based on whole-sign house positions. |
| love* | string | Love and relationship forecast. Based on Venus house position relative to this sign, providing unique guidance per sign. |
| career* | string | Career and professional outlook. Based on Mars house position relative to this sign, with Saturn and Jupiter influences. |
| health* | string | Health, energy, and wellness guidance for the day. |
| finance* | string | Financial outlook and money-related guidance. |
| advice* | string | Actionable daily advice based on the dominant transit energy. |
| luckyNumber* | number | Lucky number for the day. |
| luckyColor* | string | Lucky color for the day, derived from the sign element. |
| compatibleSigns* | array of string | Most compatible zodiac signs for this sign. Trine partners (same element) followed by a sextile partner (complementary element). Use for compatibility widgets, dating app onboarding, and horoscope cards. |
| activeTransits* | array of string | Active planetary transits affecting this sign today, with house activations. Each transit shows the planet, its current sign, and which house it activates for the queried sign. |
| moonSign* | string | Current Moon sign. Changes every 2-3 days, sets the emotional tone for all signs. |
| moonPhase* | string | Current lunar phase (New Moon, Waxing Crescent, First Quarter, Waxing Gibbous, Full Moon, Waning Gibbous, Last Quarter, Waning Crescent). |
Show all fieldsShow fewer fields
| Field | Type | Description |
|---|---|---|
| energyRating* | number | Overall energy intensity for this sign today (1-10). Higher when more transits activate this sign directly. Useful for content widgets and visual indicators. |
Supported options
sign
lang
Call it in your language in seconds.
Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.
import { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.astrology.getDailyHoroscope({ path: { sign: 'aries' } })from roxy_sdk import create_roxy
roxy = create_roxy("YOUR_API_KEY")
result = roxy.astrology.get_daily_horoscope(sign='aries')use function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->astrology->getDailyHoroscope(sign: 'aries');using RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Astrology.Horoscope["aries"].Daily.GetAsync();import roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Astrology.GetDailyHoroscope(ctx, "aries", nil)curl "https://roxyapi.com/api/v2/astrology/horoscope/aries/daily" \
-H "X-API-Key: YOUR_KEY"Prefer to try before you write code? Run this Western Astrology endpoint live in the API playground and inspect a real production response.
More Horoscope endpoints
The Horoscope API bundles these related endpoints under one key.
Monthly horoscope by zodiac sign - 30-day transit forecast with key dates
Get monthly horoscope for any zodiac sign with sign-specific week-by-week breakdown and real lunar phase key dates. Based on planetary transits with house activations unique to each sign, covering love, career, health, and finance for the entire month. Key dates include actual New Moon, Full Moon, and retrograde dates from ephemeris calculations. Monthly horoscope API, zodiac monthly forecast, astrology monthly prediction.
Try it liveWeekly horoscope by zodiac sign - 7-day transit forecast
Get weekly horoscope for any zodiac sign. Forecast covers a full 7-day period based on planetary transits with house-based content unique to each sign, with love, career, health, finance guidance plus lucky days, lucky numbers, and compatible signs. Weekly horoscope API, zodiac weekly forecast, astrology weekly prediction.
Try it liveRemote MCP for AI agents
Every Western Astrology endpoint is a callable tool on the Remote MCP server over Streamable HTTP. No local setup, no Docker. Claude, ChatGPT, Cursor, and any MCP client auto-discover the tools and ground their answers in verified data.
claude mcp add --transport http \
roxy-astrology https://roxyapi.com/mcp/astrology \
--header "X-API-Key: YOUR_KEY"Tool name for GET /astrology/horoscope/{sign}/daily: get_astrology_horoscope_sign_daily. Full MCP setup guide
What you can build
Launch natal chart apps with professional-grade accuracy: birth charts, planet positions, house placements, aspects, and element analysis ready for your UI in days
Add zodiac compatibility scoring to dating apps: synastry analysis, composite charts, and compatibility scores with detailed relationship dynamics
Ship personalized horoscope platforms: publisher-grade daily, weekly, and monthly forecasts with unique content per sign, active transit metadata, Moon phase data, and date scheduling for editorial pre-publishing
Build AI astrology chatbots with MCP: your OpenAI, Claude, or Gemini agent auto-discovers and calls every astrology endpoint with zero integration code
Power wellness and lifestyle apps with real-time transits, moon phase calendars, solar returns, and planetary movement alerts for self-discovery features
Create astrology content engines: automated zodiac content with house-based uniqueness per sign, horoscope newsletters with real lunar event dates, transit alerts, and seasonal forecasts at scale
Drop-in UI components
Render Horoscope API responses without building charts yourself. These open source, framework-agnostic web components take the typed response and draw it, in React, Vue, Svelte, Angular, plain HTML, and WordPress.
Related capabilities
Horoscope API FAQ
What does the Horoscope API return?
Get the daily horoscope for any zodiac sign. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.
How do I authenticate with the Horoscope API?
Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.
Does the Horoscope API support multiple languages?
Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.
Is the Horoscope API available over Remote MCP for AI agents?
Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/astrology over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.
How is the Horoscope API billed?
Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 12 domains, so the Horoscope API is included at no extra cost.
What sign values does the Horoscope API accept?
The sign parameter accepts aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces. Case-insensitive where it is a path value.
Start using Horoscope API today.
Ship your astrology app this weekend. Not this quarter.
All 12 domains included with every plan. Every endpoint, MCP server, SDK, and starters.
Plans from $39/mo, starting at $2.70 per domain on annual billing. No credit card required for testing.
View Pricing & Get API Key