Vedic daily factors

Every classical factor for one person on one day, in one shape, with no weighting. Each factor carries its raw value and range, its frame, the verdict its own rule gives, the rule's source, the significations it touches and the time it holds. Covers the nine gochar transits with bindus and vedha, Sade Sati, Chandra Ashtama, Tarabala and Chandrabala with the Moon's change times, the active Vimshottari dasha lords and the transits aspecting them, same-sign contacts to natal planets with the exact degree crossing, the day's tithi, yoga, karana and vara, and the Moon's phase. No weighting and no score: the caller decides what matters.

Endpoint

POST /v1/astro/daily-factors

Request parameters

Field	Type	Required	Description
location	string | null	No	City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.
name	string	No	Person name associated with the birth record
date	string	Yes	Birth date in YYYY-MM-DD format
time	string | null	No	Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.
latitude	number | null	No	Latitude. Required if location not provided.
longitude	number | null	No	Longitude. Required if location not provided.
timezone	string | null	No	IANA timezone. Required if location not provided (unless utc_offset is given). For dates before the zone adopted a standard time, the birthplace's local mean time (longitude / 15 hours) is used.
utc_offset	string | null	No	Optional explicit UTC offset of the birth time, as ±HH:MM or ±HH:MM:SS (e.g. '+04:51:31' for Bombay mean time). Overrides the offset timezone would give. Use it when the birth record states the offset, or for historical local times the IANA database cannot represent.
ayanamsa	string	No	Sidereal ayanamsa mode used in calculations
target_date	string | null	No	Day to read (YYYY-MM-DD, civil day in target_timezone). Defaults to today in the birth timezone.
target_timezone	string | null	No	IANA timezone of the day. Defaults to the birth timezone.
target_latitude	number | null	No	Place for the day's panchanga and horas. Defaults to the birthplace.
target_longitude	number | null	No	Longitude of that place, east positive. Defaults to the birthplace.

Example request

curl

curl -X POST "https://api.asterwise.com/v1/astro/daily-factors" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata","target_date":"2026-01-01"}'

Python

import asterwise
from asterwise.api.advanced_api import AdvancedApi
from asterwise.models.vedic_daily_factors_request import VedicDailyFactorsRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = VedicDailyFactorsRequest(
    name="Arjun Mehta",
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
    target_date="2026-01-01",
)

with asterwise.ApiClient(configuration) as client:
    api = AdvancedApi(client)
    result = api.vedic_daily_factors(vedic_daily_factors_request=request)
    print(result)

TypeScript

import { createClient, createConfig, vedicDailyFactors } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await vedicDailyFactors({
  client,
  body: {
      "name": "Arjun Mehta",
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata",
      "target_date": "2026-01-01"
  },
});

console.log(result.data);

Example response

Example response omitted — live API call did not return HTTP 200.

Response fields

Field	Type	Description
success	boolean	True if the request succeeded
message	string	Human-readable status message
data	object
data.birth_time_provided	boolean
data.date	string
data.timezone	string
data.instant_utc	string	The moment used for the day's transit snapshot: local noon.
data.natal	object
data.frames	object
data.factors	array[object]
data.factors[].id	string	Stable factor id, e.g. gochar.saturn, tarabala.12, natal_contact.saturn.moon.
data.factors[].group	string	gochar, sade_sati, chandra_ashtama, tarabala, chandrabala, dasha, dasha_transit, natal_contact, panchanga, moon_phase.
data.factors[].name	string
data.factors[].planet	string | null
data.factors[].frame	string	What the houses or distances are counted from. See frames.
data.factors[].value	object	The raw numbers and flags of this factor.
data.factors[].ranges	object	The documented range of each numeric value, e.g. bindus [0, 8].
data.factors[].verdict	string | null	What the classical rule says, or null when the texts give no single verdict.
data.factors[].verdict_rule	string | null	Which rule produced the verdict, in words.
data.factors[].rule_source	string | null	Text and chapter the rule comes from.
data.factors[].significations	array[string]	Ids from /v1/astro/significations touched by this factor.
data.factors[].time	object
data.factors[].time.kind	string	state: holds for the whole day; span: start to end; instant: one moment.
data.factors[].time.start	string | null
data.factors[].time.end	string | null
data.factors[].time.start_utc	string | null
data.factors[].time.end_utc	string | null
data.factors[].time.at_utc	string | null
data.factors[].depends_on_birth_time	boolean	True when an unknown birth time can change this factor.
data.counts	object	How many factors carry each verdict. A count, not a score.
data.note	string

Errors

Code	Description	Reference
api_key_invalid	Invalid API key format.	api_key_invalid
api_key_missing	API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.	api_key_missing
api_key_not_found	The provided API key was not found. Verify the key in your Asterwise dashboard.	api_key_not_found
api_key_revoked	This API key has been revoked.	api_key_revoked
burst_limit_exceeded	Too many requests per minute. Please slow down.	burst_limit_exceeded
internal_error	Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.	internal_error
ip_rate_limit_exceeded	Too many requests from this IP address. Please slow down.	ip_rate_limit_exceeded
monthly_usage_limit_exceeded	Monthly API call limit reached. Upgrade your plan to continue.	monthly_usage_limit_exceeded
payload_too_large	Request body exceeds maximum allowed size of 64KB.	payload_too_large
subscription_expired	Your subscription has expired. Please renew at asterwise.com/dashboard to continue.	subscription_expired
validation_error	The request couldn't be processed. See the 'details' field for specific field-level issues.	validation_error

Related endpoints

• Gochar — Transit Analysis
• Muhurta — Auspicious Timing
• Personal Nakshatra Prediction (Tarabala)
• Planetary transits — Gochar
• Prashna (Horary Chart)
• Tarabala and Chandrabala
• Varshaphal — Solar Return Chart
• Varshaphal — Harsha Bala
• Varshaphal — Tajika Saham Points
• Vedic events over a date range