Set up your AI agent Get started API Reference SDK Remote MCP Free Templates

Horoscope API

Transit-based editorial columns

GET/astrology/horoscope/{sign}/dailyGET/astrology/horoscope/{sign}/monthlyGET/astrology/horoscope/{sign}/weeklyGET/astrology/horoscope/{sign}/yearly

Get API Key Try it live

Remote MCP server OpenAPI schema

Included with every plan (at no extra cost)

Vedic Forecast Human Design Chinese Astrology Feng Shui Mesoamerican Vastu Numerology Kabbalah Tarot Biorhythm Ayurveda I-Ching Crystals Dreams Angel Numbers Location

13,405 tests per deploy, 3,620 gold standard 18 domains, 1 API key llms.txt for AI agents 18 Remote MCP servers, no local setup TypeScript, Python, PHP, C#, and Go SDKs with AGENTS.md

A publish-ready column for any zodiac sign, built from the dated transits over it and returned with those events for fact-checking. The reading names the aspects, sign ingresses, lunations and retrograde stations driving it and reads each into the whole-sign houses of that sign, so every sign gets different content rather than one blurb reused twelve times. Alongside the column come overview, love, career, health, finance and advice, the active transits, Moon sign and phase, an energy rating, lucky number and color, and compatible signs. No language model is involved, so a given sign and date always returns the same text and a piece scheduled months ahead is the piece that runs. Content rolls over at midnight, by default UTC. Pass date for editorial scheduling, or timezone to roll over on a local clock. Composed in 8 languages (en, de, es, fr, hi, pt, ru, tr); any other lang code returns English. 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 (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default `en`.
datequery	string (date)	Forecast date in YYYY-MM-DD format. Past and future dates are both supported, for editorial scheduling and backfill. Defaults to the current period in the timezone parameter.
timezonequery	string	Selects which period counts as current when date is omitted. Defaults to UTC, so the forecast rolls over at 00:00 UTC on each day. Pass the timezone of the end user to roll over on their local clock instead. Ignored when date is set. Accepts an IANA name (e.g. "America/New_York"), decimal hours (e.g. 5.5 for IST), or a fixed UTC offset (e.g. "-05:00").

Response

Structured JSON with documented fields, covered by 13,405 automated tests per deploy, 3,620 of them gold-standard tests verified against NASA JPL Horizons. Not hallucinated text.

200 OK

{
  "sign": "Aries",
  "date": "2026-10-13",
  "overview": "The Sun and Uranus hold a sesquiquadrate between them today, hanging the part that wants to be seen on your seventh house, the one for partnerships and relationships, where the argument that never gets finished is the one the marriage rests upon.",
  "love": "Because the Sun and Uranus hold a sesquiquadrate between them today, your seventh house is the part that moves. The part that wants to be seen does not survive contact with the interruption unchanged. Almost-alignment is worse than none, because the center of the matter keeps expecting the refusal to keep doing it this way to fall into line. Your seventh house asks for a commitment narrowed to what both people can actually keep.",
  "career": "Mercury works through Scorpio here, which is your eighth house, and it wants the sentence to survive being read back. Saturn threads through Aries, and your first house is where a person is read off how they carry themselves rather than off what they claim, carrying time, obligation, and the part of a thing that has to be earned. Reach for the boring improvement that compounds without announcing itself.",
  "health": "Seated in Aries, Saturn bears on your first house, where a person is read off how they carry themselves rather than off what they claim, and wants the thing built properly, however long that takes. Housed in Aries, Neptune reaches your first house, where posture says the thing before the mouth has opened, on dream, pity, and the difference between a fact and a feeling. Repeat the dull thing, because consistency is dull by design.",
  "finance": "Mercury marks the standing part of this from Scorpio, landing in the eighth house you keep transformation and shared resources in, over talk, paperwork, short journeys, and anything that has to be explained. Unmoved in Scorpio, the Moon holds your eighth house, where the joint account, the inheritance papers and the tax return get read line by line, and it wants the ground to feel solid before anything is risked on it. Save the unremarkable amount, since saving is unremarkable by nature.",
  "advice": "The Sun forms a sesquiquadrate to Uranus today, felt through your seventh house, the one for partnerships and relationships. Start with a commitment narrowed to what both people can actually keep.",
  "column": "The Sun forms a sesquiquadrate to Uranus today, outranking the rest of this, reaching your seventh house. Put the will beside the interruption and neither reads the same afterwards. Notice the ground first, because two names sit on one lease, one invoice or one promise, and only then what the center of the matter wants from it. Venus posts itself in Scorpio, in the eighth house you keep transformation and shared resources in, where the private accounting behind a shared arrangement comes due, wanting warmth offered before it has to be asked for. Neptune governs Aries and lays the ground here, which is the first house you keep identity and self-expression in, and a person is read off how they carry themselves rather than off what they claim. If only one thing gets done, make it a commitment narrowed to what both people can actually keep.",
  "events": [
    {
      "type": "aspect",
      "at": "2026-10-13T14:03:57Z",
      "bodies": [
        "Sun",
        "Uranus"
      ],
      "aspect": "sesquiquadrate",
      "house": 7,
      "through": "2026-10-15T13:14:42Z"
    }
  ],
  "luckyNumber": 9,
  "luckyColor": "Orange",
  "compatibleSigns": [
    "Leo",
    "Sagittarius",
    "Gemini"
  ],
  "activeTransits": [
    "Sun in Libra (your seventh house of partnerships and relationships)",
    "Moon in Scorpio (your eighth house of transformation and shared resources)",
    "Mercury in Scorpio (your eighth house of transformation and shared resources)",
    "Venus in Scorpio (your eighth house of transformation and shared resources)",
    "Venus retrograde",
    "Mars in Leo (your fifth house of romance, creativity, and joy)",
    "Jupiter in Leo (your fifth house of romance, creativity, and joy)",
    "Saturn in Aries (your first house of identity and self-expression)",
    "Saturn retrograde"
  ],
  "moonSign": "Scorpio",
  "moonPhase": "Waxing Crescent Moon",
  "energyRating": 3
}

Response fields

Field	Type	Description
sign*	string	Zodiac sign for this horoscope.
date*	string	Date of this daily horoscope (YYYY-MM-DD).
overview*	string	The single most relevant event of the period, whichever life area it touches, read into the whole-sign houses of this sign. The same event that leads column, at lede length rather than developed into a full movement, and checkable against the events array. Typically 30 to 60 words. Join it with love, career, health and finance for a general reading built from the six sections. Deterministic: the same sign and period always returns the same text.
love*	string	Love and relationship forecast, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to romance and partnership, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries romance and partnership, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 50 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
career*	string	Career and professional outlook, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to career, work and reputation, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries career, work and reputation, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 50 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
health*	string	Health, energy, and wellness guidance, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to health, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries health, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 50 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
finance*	string	Financial outlook and money-related guidance, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to finance, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries finance, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 50 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
advice*	string	The single actionable takeaway from the leading event of the period, read into the whole-sign houses of this sign and checkable against the events array. Drawn from the same event as overview, kept to a short, actionable pair of sentences rather than grown to match the other sections. Deterministic: the same sign and period always returns the same text.
column*	string	The full column for this period, ready to run as one piece, with paragraphs separated by a blank line. Names the events driving it and the dates they fall on, read into the whole-sign houses of this sign. Typically 120 to 180 words. The six section fields read the same ranked events filtered to their own life area, each composed as a column of its own rather than an excerpt of this one, so render either shape and never both. Deterministic: the same sign and period always returns the same column.
events*	array of object	The dated astronomical events this reading is built on, earliest first. Every field in every row can be checked against an independent authority, so a column can be fact-checked before it is published. Empty on a period in which nothing exact happens, where the reading falls back to the standing positions instead.
events[].type*	string enum	Kind of event. aspect is an exact angle between two moving bodies, sign-ingress a body entering a new sign, retrograde-station a body turning retrograde or direct, lunar-phase one of the four quarters, eclipse a solar or lunar eclipse, and solar-season the Sun entering a sign.
events[].at*	string	Exact instant the event perfects, UTC, to the second. Verifiable against NASA JPL Horizons for a position event and against the US Naval Observatory for a lunar phase or eclipse.
events[].bodies*	array of string	Bodies involved, canonical English regardless of the requested language so the value stays safe to switch on. Two entries for an aspect, faster body first. One entry for an ingress, a station, a lunar phase, or an eclipse.
events[].aspect	string	Angle formed, on aspect events only: conjunction, sextile, square, trine, opposition, semi-sextile, quincunx, semi-square, or sesquiquadrate.

Show all fields

Field	Type	Description
events[].sign	string	Sign the event falls in, lowercase, where it has exactly one. Absent for an aspect whose two bodies stand in different signs.
events[].house*	integer	Whole-sign house the event falls in, counted from the queried sign, 1 to 12. This is what turns one global sky event into a statement about this reader.
events[].through	string	End of the window this event holds open, UTC, given only where a bounded window is a real fact about it: the orb span of an aspect, the sign span of an ingress or a season, the retrograde span of a station. Absent for a lunar phase or an eclipse, which are instants and not spans.
luckyNumber*	number	Lucky number for the day, 1 to 9, from the traditional planetary number correspondence applied to the planet that governs this sign today. Not a random draw and not a function of the date.
luckyColor*	string	Lucky color for the day, drawn from the three colors of the sign element and selected by the planet governing the reading.
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. The sign and the house phrase translate with the lang parameter; the planet name stays canonical English so a caller can match on it whatever the language.
moonSign*	string	Current Moon sign. Changes every 2-3 days, sets the emotional tone for all signs.
moonPhase*	string	Display name of the current lunar phase, one of the eight standard phases from New Moon through Waning Crescent. Translates in place with the lang parameter, like the moonSign beside it, so render it directly.
energyRating*	number	Overall energy for this sign today (1-10). Derived from how many aspects are in force between the planets, how tight they are, whether they are harmonious or challenging, and which houses they fall in for this sign, so a busy day rates higher than a quiet one and a harmonious day higher than a hostile one of the same weight. Useful for content widgets and visual indicators.

Supported options

sign

ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspisces

lang

entrdeeshiptfrruzh-Hanszh-Hant

Call it in your language.

Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.

TypeScript

import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.astrology.getDailyHoroscope({ path: { sign: 'aries' } })

Install: npm install @roxyapi/sdk

Python

from roxy_sdk import create_roxy

roxy = create_roxy("YOUR_API_KEY")
result = roxy.astrology.get_daily_horoscope(sign='aries')

Install: pip install roxy-sdk

PHP

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->astrology->getDailyHoroscope(sign: 'aries');

Install: composer require roxyapi/sdk

using RoxyApi;

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Astrology.Horoscope["aries"].Daily.GetAsync();

Install: dotnet add package RoxyApi.Sdk

import roxyapi "github.com/RoxyAPI/sdk-go"

roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Astrology.GetDailyHoroscope(ctx, "aries", nil)

Install: go get github.com/RoxyAPI/sdk-go

cURL

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.

GET/astrology/horoscope/{sign}/monthly

Monthly horoscope by zodiac sign - Editorial column with key dates

A month-long column for any zodiac sign, plus a week-by-week breakdown and dated key dates a calendar page renders directly. The column names the major aspects, slow-planet sign changes, lunations and stations of the month, and reads each into the whole-sign houses of that sign, and those events come back beside the prose with their exact instants, so a piece can be checked against NASA JPL Horizons or the US Naval Observatory before it runs. Key dates are the real New Moon, Full Moon and retrograde instants, never approximations. Alongside the column come overview, love, career, health, finance and advice. Pass any date inside a month to retrieve that month, or timezone to roll over on a local clock. Composed in 8 languages (en, de, es, fr, hi, pt, ru, tr); any other lang code returns English. Monthly horoscope API, zodiac monthly forecast, astrology monthly prediction.

Try it live

GET/astrology/horoscope/{sign}/weekly

Weekly horoscope by zodiac sign - Seven-day editorial column

A Monday to Sunday column for any zodiac sign, naming the transits that perfect during the week and the days they fall on. Each event is read into the whole-sign houses of that sign, so content is unique per sign, and the dated events come back beside the prose so an editor can check a piece before it runs. Alongside the column come overview, love, career, health, finance and advice, plus lucky days, lucky numbers and compatible signs. No language model is involved, so the same sign and week always returns the same text. Pass any date inside a week to retrieve that week, or timezone to roll over on a local clock. Composed in 8 languages (en, de, es, fr, hi, pt, ru, tr); any other lang code returns English. Weekly horoscope API, zodiac weekly forecast, astrology weekly prediction.

Try it live

GET/astrology/horoscope/{sign}/yearly

Yearly horoscope by zodiac sign - Year ahead forecast with themes, key periods, eclipses and retrogrades

Get the year ahead for any zodiac sign, as a long-form column plus the structured arrays a year-ahead page is built from: the slow-body themes that set the backdrop, a dated key period for each of the twelve houses, the best month for love, career, health and finance, and every eclipse and every retrograde and direct station with the house it falls in for this sign. Love, career, health, finance and advice cover the whole year, and the dated events behind the copy come back beside it so an editor can check the piece before it runs. Omit the year for the one in progress, or pass any year from 1900 to 2100 to build an archive or a forecast ahead of time. Yearly horoscope API, year ahead astrology, annual zodiac forecast, eclipse and retrograde calendar.

Try it live

Remote 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 Code / Cursor

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

Add zodiac compatibility scoring to dating apps: synastry analysis, composite charts, and compatibility scores with detailed relationship dynamics

Ship personalized horoscope platforms: editorial daily, weekly, monthly, and yearly columns with unique content per sign, the dated events each one rests on returned beside the prose for fact-checking, active transit metadata, Moon phase data, and any past or future period on request 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 year-ahead pages built from every eclipse and every retrograde and direct station of the year with the house each one falls in for that sign

Drop-in UI components and no-code widgets.

Render Horoscope API responses without building charts yourself. Install the npm package and drop these into Next.js, React, Vue, Svelte, Angular, or plain HTML, or embed the very same component on Squarespace, Wix, or WordPress by pasting one snippet, with no backend and no build step. They belong to one library that covers the entire spiritual stack rather than astrology alone, MIT licensed and included in every plan at no extra cost, never a separate product and never an upsell. The Horoscope API calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.

MIT licensedFramework agnosticThemeable via CSS variablesnpm or CDN

Horoscope card: Daily, weekly, monthly, or yearly horoscope card

The complete UI libraryExplore Roxy UI

Show all Horoscope UI components

Element	Renders
<roxy-horoscope-card>	Daily, weekly, monthly, or yearly horoscope card

See them live on Roxy UI Copy-paste widgets Setup guide

Related capabilities

Natal Chart API

Synastry API

Composite Chart API

Astrology Transits API

Moon Phase API

All of Western Astrology API

Horoscope API FAQ

What does the Horoscope API return?

A publish-ready column for any zodiac sign, built from the dated transits over it and returned with those events for fact-checking. 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 18 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.

Birth charts checked cusp by cusp, and horoscopes that name the dated sky events behind each reading.

All 18 domains included with every plan. Every endpoint, MCP server, SDK, and templates.

Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.

View Pricing & Get API Key