POST/v1/western/daily-factors

Western daily factors

Every Western 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 Lilly's rules give, the rule's source, the significations it touches and the time it holds. Covers every transit-to-natal aspect with its exact time, each transiting planet's sign, dignity and natal house, the Moon's phase, sign changes and void-of-course periods, the planetary hours, and the lord of the year from annual profections. Uranus, Neptune and Pluto carry no verdict because the classical texts give none.

Request parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, the chart is cast for 06:00 local time (not a sunrise chart) and birth_time_provided is false: houses, the Ascendant, the sect and the Moon's exact degree are then approximate.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

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_offsetoptional

string | null

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.

ayanamsaoptional

string

Ignored on Western endpoints: positions are always tropical (no ayanamsa). Accepted so one birth object can be sent to Vedic and Western endpoints alike.

house_systemoptional

string

Natal house system for the natal_house of each transiting planet.

target_dateoptional

string | null

Day to read (YYYY-MM-DD, civil day in target_timezone). Defaults to today in the birth timezone.

target_timezoneoptional

string | null

IANA timezone of the day. Defaults to the birth timezone.

target_latitudeoptional

number | null

Place for the planetary hours. Defaults to the birthplace.

target_longitudeoptional

number | null

Longitude of that place, east positive. Defaults to the birthplace.

Response fields

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

string

data.natal

object

data.frames

object

data.factors

array[object]

Groups: aspect, transit, moon_phase, void_of_course, planetary_hour, profection.

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

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

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.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Western Daily Transits
• Western Monthly Transits
• Western Weekly Transits
• Western events over a date range

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/western/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.western_astrology_api import WesternAstrologyApi
from asterwise.models.western_daily_factors_request import WesternDailyFactorsRequest

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

request = WesternDailyFactorsRequest(
    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 = WesternAstrologyApi(client)
    result = api.western_daily_factors(western_daily_factors_request=request)
    print(result)

TypeScript

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

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

const result = await westernDailyFactors({
  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);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "date": "2026-01-01",
    "timezone": "Asia/Kolkata",
    "instant_utc": "2026-01-01T06:30:00Z",
    "birth_time_provided": true,
    "house_system": "placidus",
    "natal": {
      "ascendant_sign": "Scorpio",
      "sun_sign": "Scorpio",
      "moon_sign": "Scorpio"
    },
    "frames": {
      "natal_planet": "Measured against one natal planet's own position (aspects and orbs).",
      "natal_house": "The natal house the transiting planet is passing through (house_system as requested).",
      "none": "Not counted from the chart: a fact of the day or of the transiting planet itself."
    },
    "factors": [
      {
        "id": "aspect.sun.sextile.moon",
        "group": "aspect",
        "name": "Transit Sun sextile natal Moon",
        "planet": "Sun",
        "frame": "natal_planet",
        "value": {
          "natal_planet": "Moon",
          "aspect": "sextile",
          "exact_angle": 59.2397,
          "orb": 0.7603,
          "max_orb": 2.0,
          "is_applying": true,
          "exact_at": "2026-01-02T05:54:37Z",
          "days_to_exact": 0.746
        },
        "ranges": {
          "orb": [
            0,
            2.0
          ],
          "exact_angle": [
            0,
            180
          ]
        },
        "verdict": "favorable",
        "verdict_rule": "Sextile: an aspect of love and friendship",
        "rule_source": "Lilly, Christian Astrology (1647), Book 2: 'the Sextile and Trine aspects are arguments of Love, Unity and Friendship';…",
        "significations": [
          "lilly.planet.sun",
          "lilly.planet.moon"
        ],
        "time": {
          "kind": "instant",
          "at_utc": "2026-01-02T05:54:37Z"
        },
        "depends_on_birth_time": true
      },
      {
        "id": "aspect.sun.square.mars",
        "group": "aspect",
        "name": "Transit Sun square natal Mars",
        "planet": "Sun",
        "frame": "natal_planet",
        "value": {
          "natal_planet": "Mars",
          "aspect": "square",
          "exact_angle": 91.4256,
          "orb": 1.4256,
          "max_orb": 3.0,
          "is_applying": false,
          "exact_at": "2025-12-31T02:25:10Z",
          "days_to_exact": -1.399
        },
        "ranges": {
          "orb": [
            0,
            3.0
          ],
          "exact_angle": [
            0,
            180
          ]
        },
        "verdict": "unfavorable",
        "verdict_rule": "Square: a sign of imperfect enmity",
        "rule_source": "Lilly, Christian Astrology (1647), Book 2: 'the Sextile and Trine aspects are arguments of Love, Unity and Friendship';…",
        "significations": [
          "lilly.planet.sun",
          "lilly.planet.mars"
        ],
        "time": {
          "kind": "instant",
          "at_utc": "2025-12-31T02:25:10Z"
        },
        "depends_on_birth_time": false
      },
      "... and 53 more items"
    ],
    "counts": {
      "favorable": 5,
      "unfavorable": 4,
      "neutral": 8,
      "no_verdict": 38
    },
    "note": "Every factor is reported with its own classical rule and no weighting. Uranus, Neptune and Pluto carry no verdict becaus…"
  }
}