# Horoscope API

> Horoscope API. Get the daily horoscope for any zodiac sign. Forecast is generated from real-time planetary transits using whole-sign house positions, so

- Capability page: https://roxyapi.com/apis/horoscope-api
- Full domain: https://roxyapi.com/products/astrology-api
- OpenAPI spec: https://roxyapi.com/api/v2/astrology/openapi.json
- Remote MCP server: https://roxyapi.com/mcp/astrology

## Overview

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.

## Endpoints

- `GET /api/v2/astrology/horoscope/{sign}/daily` Daily horoscope by zodiac sign - Transit-based forecast with house activations
- `GET /api/v2/astrology/horoscope/{sign}/monthly` Monthly horoscope by zodiac sign - 30-day transit forecast with key dates
- `GET /api/v2/astrology/horoscope/{sign}/weekly` Weekly horoscope by zodiac sign - 7-day transit forecast

## Example request

```bash
curl "https://roxyapi.com/api/v2/astrology/horoscope/aries/daily" \
  -H "X-API-Key: YOUR_KEY"
```

## Example response

```json
{
  "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
}
```

## Remote MCP

Every endpoint is a callable tool on the Remote MCP server at https://roxyapi.com/mcp/astrology over Streamable HTTP. Tool name for `GET /astrology/horoscope/{sign}/daily`: `get_astrology_horoscope_sign_daily`. `tools/list` is free; `tools/call` bills the same as REST.

## 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.

## Full reference

Fetch the OpenAPI spec at https://roxyapi.com/api/v2/astrology/openapi.json. Master agent manifest at https://roxyapi.com/llms.txt.