Back to Docs

Daily Vedic Horoscope

Daily Vedic Horoscope

POST/api/v2/vedic/horoscope/daily/personal

Generate a premium deterministic one-day Vedic horoscope with chart context, one-day gochar insights, active Vimshottari dasha, Panchang, practical timing, explainable scores, and safe guidance.

Authentication: send x-api-key. Plan access: available on Free and paid plans.

Full URL

https://api.freeastroapi.com/api/v2/vedic/horoscope/daily/personal
Safe retries with Idempotency-Key

Authenticated, billable astrology POST requests accept the optional header Idempotency-Key: <client-generated unique operation key>. Reuse the same key only when retrying the exact same method, path, query string, and JSON body after a timeout or network failure.

A completed replay returns the first response with Idempotency-Replayed: true, does not rerun the calculation, and does not consume extra quota. Keys are retained for about 24 hours.

Reusing a key with a changed request returns 409 idempotency_key_reused. A duplicate while the first request is still running returns 409 request_in_progress with Retry-After.

What It Returns

A deterministic daily Vedic forecast with profile context, theme, explainable domain scores, narrative synthesis, six interpretation sections, Abhijit/Hora/Chaughadia timing, caution windows, compact Panchang, grouped influences, active dasha context, safe remedy guidance, and optional developer evidence.

Example Request

curl -X POST "https://api.freeastroapi.com/api/v2/vedic/horoscope/daily/personal" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "year": 1990,
  "month": 1,
  "day": 1,
  "hour": 12,
  "minute": 0,
  "city": "New Delhi",
  "lat": 28.6139,
  "lng": 77.209,
  "tz_str": "Asia/Kolkata",
  "ayanamsha": "lahiri",
  "house_system": "whole_sign",
  "node_type": "mean",
  "target_date": "2026-04-24",
  "include_evidence": true,
  "include_raw_facts": false,
  "include_interpretation_blocks": true
}'

Request Parameters

Provide either city or both lat and lng. Coordinates are recommended for stable production results.

Field
year
Type
integer
Required
Yes
Description
Birth year.
Field
month
Type
integer
Required
Yes
Description
Birth month (1-12).
Field
day
Type
integer
Required
Yes
Description
Birth day.
Field
hour
Type
integer
Required
Yes
Description
Birth hour (0-23).
Field
minute
Type
integer
Required
Yes
Description
Birth minute (0-59).
Field
city
Type
string
Required
No
Description
Birth city. Optional when lat/lng are provided.
Field
lat
Type
float
Required
No
Description
Birth latitude. Recommended for production.
Field
lng
Type
float
Required
No
Description
Birth longitude. Recommended for production.
Field
tz_str
Type
string
Required
No
Description
Optional timezone override such as Asia/Kolkata, Europe/London, AUTO, or LMT. Defaults to AUTO when omitted.
Field
ayanamsha
Type
string
Required
No
Description
Vedic ayanamsha. Default is lahiri.
Field
house_system
Type
string
Required
No
Description
House system. Default is whole_sign.
Field
node_type
Type
string
Required
No
Description
Lunar node type: mean or true.
Field
target_date
Type
string
Required
No
Description
Target local horoscope date as YYYY-MM-DD. Defaults to today in the resolved chart timezone.
Field
include_evidence
Type
boolean
Required
No
Description
Include source metadata, engine rulesets, ranked fact ids, and component evidence. Defaults to true.
Field
include_raw_facts
Type
boolean
Required
No
Description
Include raw gochar, dasha, and Panchang component payloads inside evidence. Defaults to false.
Field
include_interpretation_blocks
Type
boolean
Required
No
Description
Include deterministic daily narrative sections and remedy guidance. Defaults to true.

Response Shape

Field
meta
Type
object
Required
n/a
Description
Endpoint version, composer ruleset, target date, timezone, component rulesets, settings, and generated timestamp.
Field
profile
Type
object
Required
n/a
Description
Resolved lagna, Moon sign, Moon Nakshatra, and active Vimshottari dasha stack.
Field
theme
Type
object
Required
n/a
Description
Daily headline, primary influence, dominant dasha, and Panchang mood.
Field
scores
Type
object
Required
n/a
Description
Overall plus six domain score objects. Each includes score, band, confidence, drivers, cautions, explanation, and compact daily evidence refs.
Field
narrative
Type
object
Required
n/a
Description
Concise summary, opportunity, caution, and best_use synthesis.
Field
sections
Type
array
Required
n/a
Description
Career, wealth, relationships, health, mind, and spiritual readings with advice and traceable score evidence.
Field
timing
Type
object
Required
n/a
Description
Abhijit Muhurat, 24 Hora periods, day/night Chaughadia, curated favorable periods, Rahu Kalam, Yamaganda, Gulika, overlap warnings, and selection metadata.
Field
panchang
Type
object
Required
n/a
Description
Compact Panchang with weekday, lunar month, Tithi, Nakshatra, Yoga, Karana, sunrise, and sunset.
Field
influences
Type
object
Required
n/a
Description
Ranked one-day gochar influences with all_ranked plus primary, supporting, cautions, and background groups.
Field
dasha
Type
object
Required
n/a
Description
Active dasha periods, dominant period, Moon Nakshatra basis, reference date, and interpretation context.
Field
remedy
Type
object
Required
n/a
Description
Safe practical guidance with focus, simple_action, reflection, avoid, and basis.
Field
evidence
Type
object
Required
n/a
Description
Returned when include_evidence is true. Contains component metadata, fact_map from daily evidence refs to raw engine fact ids, timing calculation basis, score basis, and optional raw component payloads.

Real Request Example

This example asks for a one-day personalized Vedic horoscope for the target local date. Omit target_date to use today in the resolved timezone.

{
  "year": 1990,
  "month": 1,
  "day": 1,
  "hour": 12,
  "minute": 0,
  "city": "New Delhi",
  "lat": 28.6139,
  "lng": 77.209,
  "tz_str": "Asia/Kolkata",
  "ayanamsha": "lahiri",
  "house_system": "whole_sign",
  "node_type": "mean",
  "target_date": "2026-04-24",
  "include_evidence": true,
  "include_raw_facts": false,
  "include_interpretation_blocks": true
}

Real Response Example

This sample shows the premium contract shape. Production responses are deterministic from the V2 chart, gochar insights, dasha, Panchang, and sunrise/sunset timing engines.

V2
{
  "meta": {
    "endpoint": "vedic_daily_horoscope",
    "endpoint_version": "v2",
    "version": "premium_daily_v2",
    "ruleset_version": "vedic_daily_horoscope_v2",
    "rulesets": {
      "daily_horoscope": "vedic_daily_horoscope_v2",
      "chart": "classical_chart_v1",
      "dasha": "classical_dasha_v1",
      "panchang": "astrosage_panchang_v1",
      "gochar_insights": "classical_gochar_insights_v2",
      "timing": "vedic_daily_timing_v1"
    },
    "target_date": "2026-04-24",
    "timezone": "Asia/Kolkata",
    "generated_at": "2026-04-24T06:30:00Z",
    "settings": {
      "ayanamsha": "lahiri",
      "house_system": "whole_sign",
      "node_type": "mean",
      "include_evidence": true,
      "include_raw_facts": false,
      "include_interpretation_blocks": true
    }
  },
  "profile": {
    "lagna": {
      "sign": "Aries",
      "sign_id": 1,
      "degree": 12.3,
      "absolute_degree": 12.3
    },
    "moon": {
      "sign": "Taurus",
      "sign_id": 2,
      "nakshatra": "Rohini",
      "nakshatra_id": 4,
      "pada": 2,
      "nakshatra_lord": "Moon"
    },
    "active_dasha_stack": [
      {
        "level": "Mahadasha",
        "lord": "Saturn",
        "start": "2020-01-01",
        "end": "2039-01-01",
        "progress_fraction": 0.33,
        "remaining_days": 4500,
        "path": [
          "Saturn"
        ]
      },
      {
        "level": "Antardasha",
        "lord": "Jupiter",
        "start": "2025-01-01",
        "end": "2027-01-01",
        "progress_fraction": 0.5,
        "remaining_days": 300,
        "path": [
          "Saturn",
          "Jupiter"
        ]
      }
    ]
  },
  "theme": {
    "headline": "Reframing daily tone: Saturn steadies duties",
    "primary_influence": {
      "id": "daily_fact_01",
      "rank": 1,
      "fact_id": "daily_fact_01",
      "evidence_ref": "daily_fact_01",
      "title": "Saturn steadies duties",
      "summary": "Saturn asks for practical structure.",
      "polarity": "mixed",
      "category": "structure",
      "kind": "saturn_doctrine_window",
      "transit_planet": "saturn",
      "reference_point": "moon"
    },
    "dominant_dasha": {
      "level": "Mahadasha",
      "lord": "Saturn",
      "path": [
        "Saturn"
      ],
      "remaining_days": 4500
    },
    "panchang_mood": "Pushya nakshatra with Ashtami tithi and Soola yoga favors a measured, context-aware pace."
  },
  "scores": {
    "overall": {
      "score": 71,
      "band": "favorable",
      "confidence": 0.7,
      "drivers": [],
      "cautions": [],
      "explanation": "Overall daily tone is favorable at 71/100, derived from the six domain scores and the active dasha/gochar emphasis."
    },
    "career": {
      "score": 74,
      "band": "favorable",
      "confidence": 0.76,
      "drivers": [
        {
          "evidence_id": "daily_fact_01",
          "fact_id": "daily_fact_01",
          "evidence_ref": "daily_fact_01",
          "title": "Saturn steadies duties",
          "polarity": "mixed",
          "category": "structure",
          "kind": "saturn_doctrine_window",
          "transit_planet": "saturn",
          "impact": 1.74
        }
      ],
      "cautions": [],
      "explanation": "Career and duties rates favorable at 74/100. Support comes through Saturn steadies duties; no major hard driver dominates this domain."
    },
    "wealth": {
      "score": 72,
      "band": "favorable",
      "confidence": 0.69,
      "drivers": [],
      "cautions": [],
      "explanation": "Wealth and resources rates favorable at 72/100."
    },
    "relationships": {
      "score": 64,
      "band": "mixed",
      "confidence": 0.58,
      "drivers": [],
      "cautions": [],
      "explanation": "Relationships rates mixed at 64/100."
    },
    "health": {
      "score": 67,
      "band": "mixed",
      "confidence": 0.65,
      "drivers": [],
      "cautions": [],
      "explanation": "Health and vitality rates mixed at 67/100."
    },
    "mind": {
      "score": 66,
      "band": "mixed",
      "confidence": 0.62,
      "drivers": [],
      "cautions": [],
      "explanation": "Mind and emotions rates mixed at 66/100."
    },
    "spiritual": {
      "score": 72,
      "band": "favorable",
      "confidence": 0.7,
      "drivers": [],
      "cautions": [],
      "explanation": "Spiritual focus rates favorable at 72/100."
    }
  },
  "narrative": {
    "summary": "Saturn asks for practical structure. The active Vimshottari stack is Saturn / Jupiter, and the overall daily band is favorable.",
    "opportunity": "The cleanest opening is career and duties, especially during a clear favorable period.",
    "caution": "Handle relationships with extra care, and avoid forcing major moves during Rahu Kalam (10:39-12:17).",
    "best_use": "Panchang mood: Pushya nakshatra with Ashtami tithi and Soola yoga favors a measured pace. Use the strongest windows for specific work and the caution windows for review."
  },
  "sections": [
    {
      "key": "career",
      "title": "Career and duties",
      "score": 74,
      "band": "favorable",
      "confidence": 0.76,
      "summary": "Main support: Saturn steadies duties.",
      "explanation": "Career and duties rates favorable at 74/100. Support comes through Saturn steadies duties; no major hard driver dominates this domain.",
      "advice": "Use the day for duties that benefit from patience, visible accountability, and clean sequencing.",
      "drivers": [
        {
          "evidence_id": "daily_fact_01",
          "fact_id": "daily_fact_01",
          "evidence_ref": "daily_fact_01",
          "title": "Saturn steadies duties",
          "polarity": "mixed",
          "category": "structure",
          "kind": "saturn_doctrine_window",
          "transit_planet": "saturn",
          "impact": 1.74
        }
      ],
      "cautions": []
    }
  ],
  "timing": {
    "date": "2026-04-24",
    "timezone": "Asia/Kolkata",
    "sunrise": "05:45",
    "sunset": "18:50",
    "next_sunrise": "05:45",
    "abhijit": {
      "key": "abhijit_muhurat",
      "label": "Abhijit Muhurat",
      "start": "11:51",
      "end": "12:43",
      "quality": "auspicious",
      "warnings": [
        {
          "key": "rahu_kalam",
          "label": "Rahu Kalam",
          "overlap_minutes": 26,
          "message": "Overlaps Rahu Kalam for 26 minutes."
        }
      ]
    },
    "rahu_kalam": {
      "key": "rahu_kalam",
      "label": "Rahu Kalam",
      "start": "10:39",
      "end": "12:17",
      "quality": "avoid"
    },
    "yamaganda": {
      "key": "yamaganda",
      "label": "Yamaganda",
      "start": "15:33",
      "end": "17:11",
      "quality": "avoid"
    },
    "gulika": {
      "key": "gulika",
      "label": "Gulika",
      "start": "07:23",
      "end": "09:01",
      "quality": "avoid"
    },
    "hora": [
      {
        "key": "hora_1",
        "label": "Venus Hora",
        "start": "05:45",
        "end": "06:50",
        "quality": "auspicious",
        "lord": "Venus",
        "tags": [
          "relationships",
          "arts",
          "comfort"
        ]
      }
    ],
    "chaughadia": [
      {
        "key": "chaughadia_day_1",
        "label": "Char",
        "start": "05:45",
        "end": "07:23",
        "quality": "usable",
        "phase": "day"
      }
    ],
    "favorable_periods": [
      {
        "key": "abhijit_muhurat",
        "label": "Abhijit Muhurat",
        "start": "11:51",
        "end": "12:43",
        "quality": "auspicious",
        "warnings": [
          {
            "key": "rahu_kalam",
            "label": "Rahu Kalam",
            "overlap_minutes": 26
          }
        ],
        "selection_rank": 1
      }
    ],
    "favorable_period_selection": {
      "returned": 1,
      "total_candidates": 14,
      "basis": "curated_for_daily_use_from_abhijit_chaughadia_hora"
    },
    "caution_periods": [
      {
        "key": "rahu_kalam",
        "label": "Rahu Kalam",
        "start": "10:39",
        "end": "12:17",
        "quality": "avoid"
      }
    ],
    "metadata": {
      "ruleset_version": "vedic_daily_timing_v1",
      "weekday": "Friday",
      "calculation_basis": "sunrise_sunset_practical_muhurta_v1"
    }
  },
  "panchang": {
    "date": "2026-04-24",
    "weekday": {
      "number": 6,
      "name": "Friday"
    },
    "lunar_month": {
      "name": "Vaisakha",
      "amanta": true,
      "vikram_samvat": 2083
    },
    "tithi": {
      "number": 8,
      "name": "Ashtami",
      "paksha": "Shukla",
      "ends_at": "19:24:28",
      "ends_at_iso": "2026-04-24T19:24:28+05:30"
    },
    "nakshatra": {
      "number": 8,
      "name": "Pushya",
      "pada": 2,
      "lord": "Saturn",
      "ends_at": "20:15:12",
      "ends_at_iso": "2026-04-24T20:15:12+05:30"
    },
    "yoga": {
      "number": 9,
      "name": "Soola",
      "ends_at": "25:23:42",
      "ends_at_iso": "2026-04-25T01:23:42+05:30"
    },
    "karana": {
      "number": 7,
      "name": "Vishti",
      "ends_at": "08:04:04",
      "ends_at_iso": "2026-04-24T08:04:04+05:30"
    },
    "sunrise": "05:45:00",
    "sunset": "18:50:00"
  },
  "influences": {
    "all_ranked": [
      {
        "id": "daily_fact_01",
        "rank": 1,
        "fact_id": "daily_fact_01",
        "evidence_ref": "daily_fact_01",
        "title": "Saturn steadies duties",
        "summary": "Saturn asks for practical structure.",
        "polarity": "mixed"
      }
    ],
    "primary": [
      {
        "id": "daily_fact_01",
        "rank": 1,
        "fact_id": "daily_fact_01",
        "evidence_ref": "daily_fact_01",
        "title": "Saturn steadies duties",
        "summary": "Saturn asks for practical structure.",
        "polarity": "mixed"
      }
    ],
    "supporting": [],
    "cautions": [],
    "background": []
  },
  "dasha": {
    "active_periods": [
      {
        "level": "Mahadasha",
        "lord": "Saturn",
        "start": "2020-01-01",
        "end": "2039-01-01",
        "progress_fraction": 0.33,
        "remaining_days": 4500,
        "path": [
          "Saturn"
        ]
      }
    ],
    "dominant_period": {
      "level": "Mahadasha",
      "lord": "Saturn",
      "path": [
        "Saturn"
      ],
      "remaining_days": 4500
    },
    "moon_nakshatra": {
      "id": 4,
      "name": "Rohini",
      "pada": 2,
      "lord": "Moon"
    },
    "reference_date": "2026-04-24",
    "interpretation_context": "Daily events are filtered through the Saturn / Jupiter Vimshottari sequence."
  },
  "remedy": {
    "focus": "Discipline",
    "simple_action": "Finish one delayed duty before adding a new obligation.",
    "reflection": "Where would a smaller promise create more integrity today?",
    "avoid": "Avoid reacting from pressure or turning a delay into a personal verdict.",
    "basis": {
      "transit_planet": "saturn",
      "evidence_ref": "daily_fact_01",
      "panchang_nakshatra": "Pushya",
      "dominant_dasha_lord": "Saturn"
    }
  },
  "evidence": {
    "components": {
      "gochar_insights": {
        "endpoint": "vedic_gochar_timeline_insights",
        "endpoint_version": "v2",
        "ruleset_version": "classical_gochar_insights_v2",
        "range_start": "2026-04-24",
        "range_end": "2026-04-24"
      },
      "dasha": {
        "ruleset_version": "classical_dasha_v1",
        "reference_date": "2026-04-24"
      },
      "panchang": {
        "endpoint_version": "v2",
        "ruleset_version": "astrosage_panchang_v1"
      },
      "timing": {
        "ruleset_version": "vedic_daily_timing_v1",
        "calculation_basis": "sunrise_sunset_practical_muhurta_v1"
      }
    },
    "source_fact_ids": [
      "fact-saturn"
    ],
    "fact_map": [
      {
        "evidence_ref": "daily_fact_01",
        "source_fact_id": "fact-saturn",
        "rank": 1,
        "title": "Saturn steadies duties",
        "kind": "saturn_doctrine_window"
      }
    ],
    "timing_basis": {
      "calculation_basis": "sunrise_sunset_practical_muhurta_v1",
      "favorable_period_selection": {
        "returned": 1,
        "total_candidates": 14,
        "basis": "curated_for_daily_use_from_abhijit_chaughadia_hora"
      },
      "caution_windows": [
        "rahu_kalam",
        "yamaganda",
        "gulika"
      ]
    },
    "score_basis": {
      "ruleset_version": "vedic_daily_horoscope_v2",
      "domain_count": 6,
      "top_fact_count": 1
    }
  }
}

Related Docs

Gochar timeline insightsVimshottari dashaPanchangFull Vedic calculate