Western Daily Transits
asterwise_get_western_transits_daily
Current sky positions vs natal chart for a single day. Returns all 10 planets with tropical longitudes and active aspects to natal positions using transit orbs: major 3°, sextile 2°, minor 1°. Provide start_date for a specific day; defaults to today.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
birth | object | yes | Birth data for Western astrology tools (tropical zodiac). Required fields: date, time, lat, lon. Optional fields: person_name, timezone, house_system. |
response_format | enum: markdown, json | no | Output format: 'markdown' (default) for a readable report, or 'json' for the raw structured payload. |
start_date | string/null | no | Day to compute transits for, YYYY-MM-DD. Defaults to today (UTC). |
What it covers
Single-day transit snapshot: where each planet is now versus where each natal planet was at birth, with applying/separating transit-to-natal aspects using tighter transit orbs than natal chart orbs. Excludes progressions and solar arc — pure transit ephemeris.
Workflow
BEFORE: asterwise_get_western_natal — establish natal chart first.
AFTER: asterwise_get_western_transits_weekly — for week view.
Input
birth — WesternBirthData (date, time, lat, lon, timezone, house_system). house_system picks the natal houses used for natal_house (default placidus).
start_date (optional YYYY-MM-DD) — defaults to today. snapshot_time (optional HH:MM) and snapshot_timezone (IANA) read each day's sky at the user's own clock time instead of 12:00 UTC; data.snapshot_utc says which instant was used.
Output contract
data.date, data.house_system, data.birth_time_provided
data.transit_planets[] — name, longitude, sign, is_retrograde, natal_house (int 1–12 — the natal house the planet is passing through), aspects_to_natal[]
data.aspects[] — transit_planet, natal_planet, type, orb, is_applying, exact_at (string — UTC moment the aspect is exact, ISO with Z; null if none within 30 days), days_to_exact (float — days from the snapshot to exact_at, negative = already past)
data.total_aspects
Response format
response_format=json serialises the complete response as indented JSON.
response_format=markdown renders the same data as a human-readable report.
Both modes return identical underlying data.
Compute class
MEDIUM_COMPUTE (~400ms)
Errors
INVALID_PARAMS (local): WesternBirthData validation failures.
INTERNAL_ERROR: Any upstream API failure or timeout → MCP INTERNAL_ERROR
Edge cases:
Transit orbs are smaller than natal orbs: major 3°, sextile 2°, minor 1°.
Do not confuse with
asterwise_get_western_transits_weekly — 7 days vs 1 day.
asterwise_get_western_transits_monthly — 30-day window vs single day.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.