POST/v1/western/transits/daily

Western Daily Transits

Transits for one day against the natal chart: all 10 planets with tropical longitudes and their active aspects to natal positions. Orbs are the standard modern Western transit orbs: major 3°, sextile 2°, minor 1°. Each aspect carries exact_at, the UTC moment it is exact (searched 30 days either side; null if outside that window). Each transiting planet carries natal_house, the natal house it is passing through (house_system as requested; null without a birth time). The sky is read at 12:00 UTC unless snapshot_time (and snapshot_timezone) give the user's own clock time; snapshot_utc says which instant was used. Defaults to today (UTC) if no date is given.

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

House system for the natal houses that transiting planets are placed in (natal_house on each transit planet). Same choices as the natal chart; Placidus is the default.

snapshot_timeoptional

string | null

Local clock time (HH:MM) at which each day's sky is read, in snapshot_timezone. Default: 12:00 UTC, as before. Pass the user's own time so the Moon and the fast planets are where the user sees them.

snapshot_timezoneoptional

string | null

IANA timezone for snapshot_time. Defaults to the birth timezone when snapshot_time is given.

start_dateoptional

string | null

Transit reference date (YYYY-MM-DD): snapshot day for daily transits; window start for weekly (7 days) and monthly (30 days). Defaults to today.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.date

string

data.snapshot_utc

string | null

The instant this day's sky was read at, ISO 8601 UTC (12:00 UTC unless snapshot_time was given).

data.transit_planets

array[object]

data.transit_planets[].name

string

data.transit_planets[].longitude

number

data.transit_planets[].sign

string

data.transit_planets[].sign_index

integer

data.transit_planets[].degree_in_sign

number

data.transit_planets[].is_retrograde

boolean

data.transit_planets[].aspects_to_natal

array[object]

data.transit_planets[].aspects_to_natal[].transit_planet

string

data.transit_planets[].aspects_to_natal[].natal_planet

string

data.transit_planets[].aspects_to_natal[].type

string

data.transit_planets[].aspects_to_natal[].exact_angle

number

data.transit_planets[].aspects_to_natal[].orb

number

data.transit_planets[].aspects_to_natal[].is_applying

boolean

True if the transiting planet's instantaneous motion is closing the orb to the (fixed) natal planet. False if separating or exact.

data.transit_planets[].aspects_to_natal[].exact_at

string | null

When this aspect is exact: the UTC moment the transiting planet reaches the exact aspect degree (ISO 8601 with Z, to the second). Searched 30 days either side of the snapshot day. Applying aspects give the next exact moment, separating aspects the last one. Null when no exact moment falls within the 30-day search window.

data.transit_planets[].aspects_to_natal[].days_to_exact

number | null

Days from the snapshot (noon UTC on the transit day) to exact_at. Positive means the aspect is still to become exact, negative means it already was. Null when exact_at is null.

data.transit_planets[].natal_house

integer | null

Natal house (1–12) this transiting planet is passing through, using the birth chart's house cusps in the requested house_system. Null when the birth time is unknown (birth_time_provided is false), because natal houses need a birth time.

data.aspects

array[object]

data.aspects[].transit_planet

string

data.aspects[].natal_planet

string

data.aspects[].type

string

data.aspects[].exact_angle

number

data.aspects[].orb

number

data.aspects[].is_applying

boolean

True if the transiting planet's instantaneous motion is closing the orb to the (fixed) natal planet. False if separating or exact.

data.aspects[].exact_at

string | null

When this aspect is exact: the UTC moment the transiting planet reaches the exact aspect degree (ISO 8601 with Z, to the second). Searched 30 days either side of the snapshot day. Applying aspects give the next exact moment, separating aspects the last one. Null when no exact moment falls within the 30-day search window.

data.aspects[].days_to_exact

number | null

Days from the snapshot (noon UTC on the transit day) to exact_at. Positive means the aspect is still to become exact, negative means it already was. Null when exact_at is null.

data.total_aspects

integer

data.house_system

string

House system used for natal_house on each transiting planet.

data.birth_time_provided

boolean

True when a birth time was supplied. False when it was not: natal_house is then null for every transiting planet, and natal positions were computed for 06:00 local time.

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 Monthly Transits
• Western Weekly Transits
• Western daily factors
• Western events over a date range

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/western/transits/daily" \
  -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","start_date":"2026-01-01"}'

Python

import asterwise
from asterwise.api.western_astrology_api import WesternAstrologyApi
from asterwise.models.western_transit_request import WesternTransitRequest

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

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

with asterwise.ApiClient(configuration) as client:
    api = WesternAstrologyApi(client)
    result = api.western_transits_daily(western_transit_request=request)
    print(result)

TypeScript

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

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

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

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "date": "2026-01-01",
    "snapshot_utc": "2026-01-01T12:00:00Z",
    "transit_planets": [
      {
        "name": "Sun",
        "longitude": 281.07802,
        "sign": "Capricorn",
        "sign_index": 9,
        "degree_in_sign": 11.07802,
        "is_retrograde": false,
        "aspects_to_natal": [
          {
            "transit_planet": "Sun",
            "natal_planet": "Moon",
            "type": "sextile",
            "exact_angle": 59.2397,
            "orb": 0.7603,
            "is_applying": true,
            "exact_at": "2026-01-02T05:54:37Z",
            "days_to_exact": 0.746
          },
          {
            "transit_planet": "Sun",
            "natal_planet": "Mars",
            "type": "square",
            "exact_angle": 91.4256,
            "orb": 1.4256,
            "is_applying": false,
            "exact_at": "2025-12-31T02:25:10Z",
            "days_to_exact": -1.399
          }
        ],
        "natal_house": 2
      },
      {
        "name": "Moon",
        "longitude": 74.225251,
        "sign": "Gemini",
        "sign_index": 2,
        "degree_in_sign": 14.225251,
        "is_retrograde": false,
        "aspects_to_natal": [
          {
            "transit_planet": "Moon",
            "natal_planet": "Mercury",
            "type": "opposition",
            "exact_angle": 177.9538,
            "orb": 2.0462,
            "is_applying": false,
            "exact_at": "2026-01-01T08:44:04Z",
            "days_to_exact": -0.136
          },
          {
            "transit_planet": "Moon",
            "natal_planet": "Uranus",
            "type": "opposition",
            "exact_angle": 177.707,
            "orb": 2.293,
            "is_applying": true,
            "exact_at": "2026-01-01T15:39:24Z",
            "days_to_exact": 0.152
          }
        ],
        "natal_house": 7
      },
      "... and 8 more items"
    ],
    "aspects": [
      {
        "transit_planet": "Sun",
        "natal_planet": "Moon",
        "type": "sextile",
        "exact_angle": 59.2397,
        "orb": 0.7603,
        "is_applying": true,
        "exact_at": "2026-01-02T05:54:37Z",
        "days_to_exact": 0.746
      },
      {
        "transit_planet": "Sun",
        "natal_planet": "Mars",
        "type": "square",
        "exact_angle": 91.4256,
        "orb": 1.4256,
        "is_applying": false,
        "exact_at": "2025-12-31T02:25:10Z",
        "days_to_exact": -1.399
      },
      "... and 16 more items"
    ],
    "total_aspects": 18,
    "house_system": "placidus",
    "birth_time_provided": true
  }
}