Input schema (JSON)
{
"type": "object",
"examples": [
{
"birthData": {
"date": "1990-07-15",
"time": "13:30:00",
"timezone": "America/New_York"
}
}
],
"required": [
"birthData"
],
"properties": {
"top": {
"type": "integer",
"example": 3,
"maximum": 20,
"minimum": 0,
"description": "Number of highest-significance events to surface per window. Defaults to 3, capped at 20."
},
"lang": {
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru",
"zh-Hans",
"zh-Hant"
],
"type": "string",
"default": "en",
"example": "en",
"description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
},
"compact": {
"type": "boolean",
"default": false,
"description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
},
"domains": {
"type": "array",
"items": {
"enum": [
"western",
"vedic",
"biorhythm"
],
"type": "string",
"example": "western",
"description": "Forecast domain. western covers transit aspects, sign ingresses, retrograde stations, eclipses, and new and full moons. vedic covers Vimshottari mahadasha, antardasha, and pratyantardasha boundaries. biorhythm covers critical days."
},
"example": [
"western",
"vedic",
"biorhythm"
],
"description": "Which forecast domains to include before rolling up the windows. Defaults to all three."
},
"birthData": {
"type": "object",
"required": [
"date",
"time",
"timezone"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"example": "1990-07-15",
"description": "Birth date in YYYY-MM-DD format. Anchors the natal chart and the Vimshottari dasha sequence."
},
"time": {
"type": "string",
"format": "time",
"example": "13:30:00",
"description": "Birth time in 24-hour HH:MM:SS format. Precision matters for the natal positions the transit aspects are measured against."
},
"latitude": {
"type": "number",
"default": 0,
"example": 0,
"maximum": 90,
"minimum": -90,
"description": "Birth latitude in decimal degrees. Optional and does not affect the timeline. Defaults to 0."
},
"timezone": {
"anyOf": [
{
"type": "number",
"maximum": 14,
"minimum": -14
},
{
"type": "string"
}
],
"example": "America/New_York",
"description": "IANA name (e.g. \"America/New_York\", \"Europe/London\", \"UTC\"), decimal hours (e.g. -5 for EST, 1 for CET), or a fixed UTC offset (e.g. \"-05:00\", \"+01:00\"). Prefer the IANA name: it is resolved to the offset in force at the birth date and time, historical daylight-saving rules included, while a fixed offset or decimal is taken literally and will be wrong if it does not match the daylight-saving state at that moment. On a transition day a time in the repeated hour is read as its first occurrence and a time in the skipped hour is moved forward past the gap. Invalid timezones return 400 with a validation error."
},
"longitude": {
"type": "number",
"default": 0,
"example": 0,
"maximum": 180,
"minimum": -180,
"description": "Birth longitude in decimal degrees. Optional and does not affect the timeline. Defaults to 0."
}
},
"description": "The single birth subject this digest is built for. One object only, never an array."
},
"startDate": {
"type": "string",
"format": "date",
"example": "2026-06-01",
"description": "Start anchor for every window in YYYY-MM-DD format. The next 24h, 7d, 30d, and 90d windows are measured forward from this date at 00:00:00 UTC. Defaults to today in UTC."
},
"domainWeights": {
"type": "object",
"example": {
"vedic": 1.5,
"biorhythm": 0.5
},
"properties": {
"vedic": {
"type": "number",
"example": 1.5,
"maximum": 100,
"minimum": 0,
"description": "Multiplier for this domain significance. 1 leaves it unchanged, above 1 promotes the domain, below 1 demotes it."
},
"western": {
"type": "number",
"example": 1.5,
"maximum": 100,
"minimum": 0,
"description": "Multiplier for this domain significance. 1 leaves it unchanged, above 1 promotes the domain, below 1 demotes it."
},
"biorhythm": {
"type": "number",
"example": 1.5,
"maximum": 100,
"minimum": 0,
"description": "Multiplier for this domain significance. 1 leaves it unchanged, above 1 promotes the domain, below 1 demotes it."
}
},
"description": "Per-domain significance multipliers applied before the significance floor and event cap. Bias which domains survive filtering and the cap. Omitted domains default to a weight of 1. Valid keys are western, vedic, and biorhythm."
},
"minSignificance": {
"type": "number",
"example": 0,
"maximum": 100,
"minimum": 0,
"description": "Drop events scoring below this significance threshold from 0 to 100 before the rollup. Defaults to 0."
}
}
}