Daily Sign Horoscope

The Daily Sign Horoscope endpoint provides general forecasts for each of the 12 zodiac signs. It serves as an excellent entry-point feature for apps, offering daily engagement without requiring full birth details.

GET/api/v2/horoscope/daily/sign

Endpoint Overview

Returns scores (0-100) for love, career, money, and health, along with a written forecast, lucky attributes, and moon phase data.

Query Parameters

Parameter	Type	Required	Description
sign	string	Yes	Zodiac sign (aries, taurus, gemini, etc.)
date	string	No	Date for the horoscope (YYYY-MM-DD) or 'today'. Default: today
tz_str	string	No	Timezone string (e.g. 'Europe/Paris' or 'AUTO'). Default: AUTO
locale	string	No	Language code (en, fr, etc.). Default: en

Example Request

curl -G "https://api.freeastroapi.com/api/v2/horoscope/daily/sign" \
 -d "sign=aries" \
 -d "date=today" \
 -d "tz_str=Europe/Paris"

Response Example

{
  "meta": {
    "request_id": "req_3e283335",
    "generated_at": "2026-02-13T10:58:07",
    "settings": {
      "date_resolved": "2026-02-13",
      "version": "v2"
    },
    "engine": {
      "name": "DailyHoroscopeEngine",
      "version": "2.0.0"
    }
  },
  "data": {
    "sign": "aries",
    "date": "2026-02-13",
    "scores": { "overall": 74, "love": 93, "career": 88, "money": 83, "health": 97 },
    "lucky": {
      "color": { "key": "white", "label": "White" },
      "number": 13,
      "time_window": "10am - 4pm"
    },
    "content": {
      "text": "When this influence is active, emotions run ahead of willpower... With the Moon in Capricorn...",
      "theme": "Initiative",
      "keywords": ["Initiative", "Energy"],
      "do": ["Trust your intuition", "Take small steps"],
      "dont": ["Overthink small details", "Rush into decisions"],
      "supporting_insights": [
        "Notice where you overcommit to earn approval...",
        "Channel urgency into a clear plan..."
      ]
    },
    "astro": {
      "moon_sign": { "key": "capricorn", "label": "Capricorn" },
      "moon_phase": { "key": "last_quarter", "label": "Last Quarter" },
      "highlights": [
        { "type": "moon_sign", "key": "capricorn", "label": "Moon in Capricorn" },
        { "type": "sky_aspect", "key": "moon_sextile_mercury", "label": "Moon Sextile Mercury" }
      ]
    }
  }
}