All-signs horoscope

GET /v1/horoscope?period=daily&locale=ne

Returns cached general horoscopes for all 12 zodiac signs in one request. No profileId required — results are anchored to Kathmandu and shared across all users. Useful for building horoscope listing pages or prefetching all signs at once.

Cost: 5 credits

---

Query parameters

Parameter	Required	Values
period	No	daily (default) · weekly · monthly · yearly
locale	No	en · hi · ne — falls back to x-locale header, then en

---

Example

curl "https://api.askvedicguru.com/api/v1/horoscope?period=daily&locale=ne" \
  -H "X-API-Key: YOUR_API_KEY"

---

Response

{
  "success": true,
  "data": [
    {
      "sign": "Aries",
      "moonSign": "मेष",
      "period": "daily",
      "periodLabel": "१४ बैशाख, २०८३",
      "periodDate": {
        "adYear": 2026,
        "adMonth": "May",
        "adMonthNum": 5,
        "adDay": 14,
        "bsYear": 2083,
        "bsMonth": "Baisakh",
        "bsMonthNum": 1,
        "bsDay": 1
      },
      "locale": "ne",
      "overallScore": 3.6,
      "overallScoreLabel": "राम्रो",
      "highlights": [
        "बृहस्पति भाव ११ (कुम्भ): लाभ सक्रियकर्ता — नेटवर्किङबाट आर्थिक अवसर आउँछन्।"
      ],
      "cautions": [
        "शनि भाव १२ (तुला): छिपेका बाधाहरू — दीर्घकालीन योजनामा ढिलाइ हुन सक्छ।"
      ],
      "transits": [
        {
          "planet": "बृहस्पति",
          "currentSign": "वृष",
          "houseFromMoon": 2,
          "isRetrograde": false,
          "title": "धन सम्पन्नता",
          "effects": ["आर्थिक वृद्धि र पारिवारिक सम्बन्ध सुधार।"],
          "career": "व्यावसायिक अवसर बढ्छन्।",
          "health": "स्वास्थ्य सामान्य राम्रो।",
          "relationships": "परिवारसँग राम्रो समय।",
          "finance": "आम्दानी बढ्न सक्छ।",
          "score": 4,
          "scoreLabel": "उत्कृष्ट"
        }
      ],
      "areas": {
        "career":        { "score": 4.0, "scoreLabel": "उत्कृष्ट", "summary": "..." },
        "health":        { "score": 3.2, "scoreLabel": "राम्रो",    "summary": "..." },
        "relationships": { "score": 3.5, "scoreLabel": "राम्रो",    "summary": "..." },
        "finance":       { "score": 3.8, "scoreLabel": "राम्रो",    "summary": "..." }
      },
      "luckyFactors": {
        "color": "रातो",
        "number": 9,
        "day": "मंगलबार",
        "gemstone": "मूंगा"
      },
      "prediction": "आजको दिन मेष राशिका लागि...",
      "validFrom": "2026-05-13T18:15:00.000Z",
      "validUntil": "2026-05-14T18:15:00.000Z"
    },
    {
      "sign": "Taurus",
      "..."
    }
  ]
}

The array always contains all 12 signs in canonical order: Aries → Taurus → Gemini → Cancer → Leo → Virgo → Libra → Scorpio → Sagittarius → Capricorn → Aquarius → Pisces

---

Field reference

Field	Description
sign	English sign name — use this as the canonical key
moonSign	Localized sign name in the requested locale
period	Period type: daily, weekly, monthly, or yearly
periodLabel	Human-readable period string in the requested locale
periodDate	AD + BS date components — see table below
overallScore	Transit-weighted score (1–5, one decimal)
overallScoreLabel	Localized label for the overall score
highlights	Favourable transit summaries
cautions	Challenging transit summaries
transits	Per-planet transit details — see table below
areas	Life area scores and summaries
luckyFactors	Lucky color, number, day, and gemstone
prediction	AI-generated prose horoscope
validFrom	UTC timestamp when this result becomes valid
validUntil	UTC timestamp when this result expires

periodDate fields

Field	Description
adYear	AD year
adMonth	AD month name (e.g. "May")
adMonthNum	AD month number (1–12)
adDay	Day number (daily only)
adDayEnd	End day (weekly only)
adMonthEnd	End month name (weekly, if different)
bsYear	BS year
bsMonth	BS month name (e.g. "Baisakh")
bsMonthNum	BS month number (1–12)
bsDay	BS day (daily only)
bsDayEnd	BS end day (weekly only)
bsMonthEnd	BS end month name (weekly, if different)
bsYearEnd	BS end year (weekly, if week crosses a BS year)

transits[] fields

Field	Description
planet	Localized planet name
currentSign	Localized sign the planet currently occupies
houseFromMoon	House number counted from the Moon sign (1–12)
isRetrograde	Whether the planet is retrograde
title	Short label for this transit's effect
effects	Array of effect descriptions
career / health / relationships / finance	Domain-specific effect text
score	Transit score (1–5)
scoreLabel	Localized score label

---

Caching behaviour

Results are pre-computed and cached in MongoDB with a TTL per period:

Period	Cache duration
daily	Until midnight Asia/Kathmandu
weekly	Until next Monday midnight Asia/Kathmandu
monthly	Until 1st of next month midnight Asia/Kathmandu
yearly	Until 1 Jan midnight Asia/Kathmandu

A cron job prefetches all 12 signs before expiry so most requests hit the cache. On a cold cache miss, the first request triggers an inline compute (may take a few seconds).