Servers Playground How we check Add a server Log in

AstroWay Forecasting

Working · 262 ms

info.astroway/forecastv0.4.3 Domain verified

Transits, progressions, directions, returns, cosmobiology and evolutionary technique.

Entertainment & Games

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.astroway.info/mcp/forecast

Authorization (required)

Bearer followed by your AstroWay API key (aw_live_* or aw_test_*), from api.astroway.info/dashboard

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

astroway_account_status Read-only

Check current API key status: tier, credit balance, rate limits, monthly cycle reset. Run this BEFORE invoking expensive endpoints (Tier 4+ at 100+ credits, Tier 6/7 at 500-5000 credits) to confirm the user has budget. Returns plain-text human-readable summary.

This tool takes no arguments.

AstroWay Forecasting MCP server | mcptry

AstroWay Forecasting

Working · 262 ms

info.astroway/forecastv0.4.3 Domain verified

Transits, progressions, directions, returns, cosmobiology and evolutionary technique.

Entertainment & Games

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.astroway.info/mcp/forecast

Authorization (required)

Bearer followed by your AstroWay API key (aw_live_* or aw_test_*), from api.astroway.info/dashboard

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

astroway_account_status Read-only

This tool takes no arguments.

Tools (45)

astroway_account_status

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

astroway_agent_tools

Tool definitions for an agent framework, generated from the live OpenAPI document, so the schema a model fills is the schema the endpoint validates. `format=openai` (default) returns `{ type, function }` objects you can spread straight into a chat completion; `format=anthropic` returns `{ name, description, input_schema }`. The objects carry nothing of ours: how to call each tool lives in a separate `executors` map keyed by tool name, because an unexpected key inside a vendor tool object is a 400 at their end. [Group: Agent Platform] [Endpoint: GET /v1/agent/tools] [Cost: see your plan — endpoint not in the public credit manifest]

read-only

Argument	Type	Description
q	string	Free-text filter applied within the selection, matched against path, summary, description and group.
limit	integer	How many tools to return. The ceiling is the OpenAI limit of 128 functions per request; models degrade well before it. Anything left out is counted in `totalMatched`.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
format	string	Which vendor contract the tool objects follow. `openai` returns `{ type, function }`, `anthropic` returns `{ name, description, input_schema }`.
select	string	What to hand over: `starter` (the curated set, the default), `all`, `group:<tag>` such as `group:Vedic`, or `paths:/chart,/synastry` for an explicit list. An unknown path is named in `notes` rather than dropped.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 120,
      "description": "Free-text filter applied within the selection, matched against path, summary, description and group."
    },
    "limit": {
      "type": "integer",
      "default": 32,
      "maximum": 128,
      "minimum": 1,
      "description": "How many tools to return. The ceiling is the OpenAI limit of 128 functions per request; models degrade well before it. Anything left out is counted in `totalMatched`."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "format": {
      "enum": [
        "openai",
        "anthropic"
      ],
      "type": "string",
      "default": "openai",
      "description": "Which vendor contract the tool objects follow. `openai` returns `{ type, function }`, `anthropic` returns `{ name, description, input_schema }`."
    },
    "select": {
      "type": "string",
      "default": "starter",
      "description": "What to hand over: `starter` (the curated set, the default), `all`, `group:<tag>` such as `group:Vedic`, or `paths:/chart,/synastry` for an explicit list. An unknown path is named in `notes` rather than dropped."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_cosmobiology_cosmogram

Ebertin cosmogram render data. [Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/cosmogram] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
withTnp	boolean
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_cosmobiology_dial_90

All chart points in 90° cardinal modulus. [Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/dial-90] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
withTnp	boolean
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_cosmobiology_eight_harmonic_aspects

22.5° / 45° / 67.5° / 90° / 135° aspects. [Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/eight-harmonic-aspects] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
withTnp	boolean
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string

astroway_cosmobiology_lefeldt_extensions

Lefeldt-Brummund 22.5° subdivisions. [Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/lefeldt-extensions] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
withTnp	boolean
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_cosmobiology_midpoint_pictures

A=B/C structures with sentence form. [Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/midpoint-pictures] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
withTnp	boolean
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_cosmobiology_personal_point_tree

Tree per personal point. [Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/personal-point-tree] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
withTnp	boolean
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_cosmobiology_sensitive_points

Ebertin's personal points midpoint hits. [Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/sensitive-points] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
withTnp	boolean
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_cosmobiology_transit_midpoints

Transits hitting natal midpoints in 90° dial. [Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/transit-midpoints] [Required: date, time, latitude, longitude, targetDate] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
withTnp	boolean
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
converse	boolean
latitude*	number

astroway_cosmobiology_uranian_tnps

8 Hamburg trans-Neptunian bodies. [Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/uranian-tnps] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_cosmobiology_witte_formulas

Witte planetary pictures A+B−C=D. [Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/witte-formulas] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
withTnp	boolean
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_cost_estimate

Estimate the credit cost of one or more endpoints WITHOUT invoking them. Returns total + per-endpoint breakdown with tier annotations. Useful when planning multi-step workflows: estimate first, ask user confirmation, then invoke. Cache TTL 5 min.

read-only

Argument	Type	Description
endpoints*	array	Endpoint paths to estimate, e.g. ["/chart", "/synastry", "/reports/natal"]. Leading slash optional.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "endpoints"
  ],
  "properties": {
    "endpoints": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "examples": [
        [
          "/chart"
        ],
        [
          "/chart",
          "/synastry"
        ],
        [
          "/chart",
          "/transits",
          "/reports/natal"
        ]
      ],
      "minItems": 1,
      "description": "Endpoint paths to estimate, e.g. [\"/chart\", \"/synastry\", \"/reports/natal\"]. Leading slash optional."
    }
  }
}

astroway_evolutionary_nodal_axis_detail

Full NN/SN with rulers + conjuncts. [Group: Evolutionary Astrology] [Endpoint: POST /v1/evolutionary/nodal-axis-detail] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_evolutionary_pluto_natal_condition

JWG: Pluto sign+house+ruler+hard aspects. [Group: Evolutionary Astrology] [Endpoint: POST /v1/evolutionary/pluto-natal-condition] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_evolutionary_skipped_steps

Planets squaring nodal axis = unfinished karma. [Group: Evolutionary Astrology] [Endpoint: POST /v1/evolutionary/skipped-steps] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_evolutionary_soul_types

JWG's 4-type by Pluto house quadrant. [Group: Evolutionary Astrology] [Endpoint: POST /v1/evolutionary/soul-types] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_evolutionary_yesterday_sky

Forrest 2008 past-life method. [Group: Evolutionary Astrology] [Endpoint: POST /v1/evolutionary/yesterday-sky] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_mcp_agent_debate

2 personas debate a topic, multi-round transcript. [Group: MCP Advanced] [Endpoint: POST /v1/mcp/agent-debate] [Required: topic, agentA, agentB] [Cost: 100 credits (Tier 4)]

read-only

Argument	Type	Description
chart	object	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
topic*	string
agentA*	string
agentB*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
rounds	integer

astroway_mcp_agent_pool_status

8 personas with specialties. [Group: MCP Advanced] [Endpoint: GET /v1/mcp/agent-pool-status] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_mcp_ai_chat

Chat answered from the positions we computed for this birth moment, not from the model's memory of a sun sign. Carries up to 10 turns of history, replies in 21 languages, and takes four voices through `persona`. Send your own provider key and the turn costs 5 credits instead of the endpoint price. [Group: AI & MCP] [Endpoint: POST /v1/ai/chat] [Required: message] [Cost: 100 credits (Tier 4)]

read-only

Argument	Type	Description
chart	object	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
history	array
message*	string
persona	string

astroway_mcp_ai_comparison_coach

Coach two charts on relationship dynamics. [Group: AI & MCP] [Endpoint: POST /v1/ai/comparison-coach] [Required: chart1, chart2, question] [Cost: 100 credits (Tier 4)]

read-only

Argument	Type	Description
chart1*	object	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
chart2*	object	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.

astroway_mcp_ai_explain_aspect

Detailed explanation of an aspect between two planets. [Group: AI & MCP] [Endpoint: POST /v1/ai/explain-aspect] [Required: planet1, planet2, aspectType] [Cost: 100 credits (Tier 4)]

read-only

Argument	Type	Description
chart	object	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
planet1*	string
planet2*	string
language	string
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

astroway_mcp_ai_explain_transit

Explain a current transit hitting your natal chart. [Group: AI & MCP] [Endpoint: POST /v1/ai/explain-transit] [Required: chart, transitDate, transitPlanet, natalPlanet, aspectType] [Cost: 100 credits (Tier 4)]

read-only

Argument	Type	Description
chart*	object	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
language	string
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
aspectType*	string

astroway_mcp_multi_agent_coordinate

Run N personas in parallel + LLM synthesis. [Group: MCP Advanced] [Endpoint: POST /v1/mcp/multi-agent-coordinate] [Required: question, agents] [Cost: 100 credits (Tier 4)]

read-only

Argument	Type	Description
chart	object	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
agents*	array
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
language	string
question*	string
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

astroway_mcp_multi_chart_context

Compact context for MCP agents working across multiple charts. [Group: AI & MCP] [Endpoint: POST /v1/mcp/multi-chart-context] [Required: charts] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
charts*	array
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
intent	string
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "charts"
  ],
  "properties": {
    "charts": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "date",
          "time",
          "latitude",
          "longitude"
        ],
        "properties": {
          "city": {
            "type": "string",
            "default": ""
          },
          "date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "name": {
            "type": "string",
            "default": ""
          },
          "time": {
            "type": "string",
            "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
          },
          "ayanamsa": {
            "enum": [
              "fagan-bradley",
              "lahiri",
              "de-luce",
              "raman",
              "krishnamurti",
              "kp",
              "yukteshwar",
              "jn-bhasin",
              "true-citra",
              "djwhal-khul"
            ],
            "type": "string",
            "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
          },
          "latitude": {
            "type": "number",
            "maximum": 90,
            "minimum": -90
          },
          "timezone": {
            "type": "string",
            "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
          },
          "cosmogram": {
            "type": "boolean"
          },
          "longitude": {
            "type": "number",
            "maximum": 180,
            "minimum": -180
          },
          "ayanamsaId": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "zodiacType": {
            "enum": [
              "tropical",
              "sidereal"
            ],
            "type": "string"
          },
          "houseSystem": {
            "enum": [
              "P",
              "K",
              "R",
              "C",
              "E",
              "W",
              "B",
              "M",
              "O",
              "A",
              "T",
              "V",
              "D",
              "F",
              "G",
              "H",
              "I",
              "i",
              "L",
              "N",
              "Q",
              "S",
              "U",
              "X",
              "Y"
            ],
            "type": "string",
            "default": "P"
          },
          "timezoneOffset": {
            "anyOf": [
              {
                "type": "number",
                "maximum": 14,
                "minimum": -14
              },
              {
                "type": "null"
              }
            ],
            "default": 0,
            "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
          }
        },
        "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
        "additionalProperties": {
          "anyOf": [
            {},
            {
              "type": "null"
            }
          ]
        }
      },
      "maxItems": 6,
      "minItems": 1
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "intent": {
      "enum": [
        "compatibility",
        "family",
        "group",
        "forecast"
      ],
      "type": "string"
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_mcp_rag_search

Keyword-tag scoring over chart chunks. [Group: MCP Advanced] [Endpoint: POST /v1/mcp/rag-search] [Required: query, chart] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
topK	integer
chart*	object	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
query*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

astroway_mcp_streaming

Server-Sent Events streaming chat completion with optional chart context. [Group: AI & MCP] [Endpoint: POST /v1/mcp/streaming] [Required: message] [Cost: 100 credits (Tier 4)]

read-only

Argument	Type	Description
chart	object	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
message*	string
language	string
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

astroway_mcp_tool_call_stream

SSE-stream of a tool call envelope. [Group: MCP Advanced] [Endpoint: POST /v1/mcp/tool-call-stream] [Required: tool] [Cost: 10 credits (Tier 1)]

read-only

Argument	Type	Description
args	object
tool*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
language	string
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "tool"
  ],
  "properties": {
    "args": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {},
          {
            "type": "null"
          }
        ]
      }
    },
    "tool": {
      "type": "string",
      "maxLength": 80,
      "minLength": 2
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "language": {
      "enum": [
        "uk",
        "en",
        "ru",
        "es",
        "pl",
        "de",
        "fr",
        "it",
        "pt"
      ],
      "type": "string",
      "default": "en"
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_mcp_tools_list

Auto-generated tool manifest for MCP clients (modelcontextprotocol/2025-03 spec). [Group: AI & MCP] [Endpoint: GET /v1/mcp/tools-list] [Cost: see your plan — endpoint not in the public credit manifest]

read-only

Argument	Type	Description
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_prognostics_firdaria

Calculate Firdaria planetary periods: the traditional Persian time-lord system based on sect and planet order. [Group: Prognostics] [Endpoint: POST /v1/firdaria] [Cost: 20 credits (Tier 2)]

read-only

Argument	Type	Description
body*	any	Natal chart plus the number of years of firdaria periods to return.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "allOf": [
        {
          "type": "object",
          "required": [
            "date",
            "time",
            "latitude",
            "longitude"
          ],
          "properties": {
            "city": {
              "type": "string",
              "default": ""
            },
            "date": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "name": {
              "type": "string",
              "default": ""
            },
            "time": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "ayanamsa": {
              "enum": [
                "fagan-bradley",
                "lahiri",
                "de-luce",
                "raman",
                "krishnamurti",
                "kp",
                "yukteshwar",
                "jn-bhasin",
                "true-citra",
                "djwhal-khul"
              ],
              "type": "string",
              "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
            },
            "latitude": {
              "type": "number",
              "maximum": 90,
              "minimum": -90
            },
            "timezone": {
              "type": "string",
              "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
            },
            "cosmogram": {
              "type": "boolean"
            },
            "longitude": {
              "type": "number",
              "maximum": 180,
              "minimum": -180
            },
            "ayanamsaId": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "zodiacType": {
              "enum": [
                "tropical",
                "sidereal"
              ],
              "type": "string"
            },
            "houseSystem": {
              "enum": [
                "P",
                "K",
                "R",
                "C",
                "E",
                "W",
                "B",
                "M",
                "O",
                "A",
                "T",
                "V",
                "D",
                "F",
                "G",
                "H",
                "I",
                "i",
                "L",
                "N",
                "Q",
                "S",
                "U",
                "X",
                "Y"
              ],
              "type": "string",
              "default": "P"
            },
            "timezoneOffset": {
              "anyOf": [
                {
                  "type": "number",
                  "maximum": 14,
                  "minimum": -14
                },
                {
                  "type": "null"
                }
              ],
              "default": 0,
              "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
            }
          },
          "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        },
        {
          "type": "object",
          "properties": {
            "maxYears": {
              "type": "integer",
              "maximum": 200,
              "exclusiveMinimum": 0
            }
          },
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        }
      ],
      "description": "Natal chart plus the number of years of firdaria periods to return."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_prognostics_forecast_calendar

Generate a combined forecast calendar including transits, lunar phases, ingresses, and retrograde stations for a given period. [Group: Prognostics] [Endpoint: POST /v1/forecast-calendar] [Cost: 100 credits (Tier 4)]

read-only

Argument	Type	Description
body*	any	Wrapper { natal: ChartInput } used by endpoints that take a base natal plus extra parameters in flat fields.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "allOf": [
        {
          "type": "object",
          "required": [
            "natal"
          ],
          "properties": {
            "natal": {
              "type": "object",
              "required": [
                "date",
                "time",
                "latitude",
                "longitude"
              ],
              "properties": {
                "city": {
                  "type": "string",
                  "default": ""
                },
                "date": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                },
                "name": {
                  "type": "string",
                  "default": ""
                },
                "time": {
                  "type": "string",
                  "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
                },
                "ayanamsa": {
                  "enum": [
                    "fagan-bradley",
                    "lahiri",
                    "de-luce",
                    "raman",
                    "krishnamurti",
                    "kp",
                    "yukteshwar",
                    "jn-bhasin",
                    "true-citra",
                    "djwhal-khul"
                  ],
                  "type": "string",
                  "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
                },
                "latitude": {
                  "type": "number",
                  "maximum": 90,
                  "minimum": -90
                },
                "timezone": {
                  "type": "string",
                  "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
                },
                "cosmogram": {
                  "type": "boolean"
                },
                "longitude": {
                  "type": "number",
                  "maximum": 180,
                  "minimum": -180
                },
                "ayanamsaId": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "zodiacType": {
                  "enum": [
                    "tropical",
                    "sidereal"
                  ],
                  "type": "string"
                },
                "houseSystem": {
                  "enum": [
                    "P",
                    "K",
                    "R",
                    "C",
                    "E",
                    "W",
                    "B",
                    "M",
                    "O",
                    "A",
                    "T",
                    "V",
                    "D",
                    "F",
                    "G",
                    "H",
                    "I",
                    "i",
                    "L",
                    "N",
                    "Q",
                    "S",
                    "U",
                    "X",
                    "Y"
                  ],
                  "type": "string",
                  "default": "P"
                },
                "timezoneOffset": {
                  "anyOf": [
                    {
                      "type": "number",
                      "maximum": 14,
                      "minimum": -14
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": 0,
                  "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
                }
              },
              "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
              "additionalProperties": {
                "anyOf": [
                  {},
                  {
                    "type": "null"
                  }
                ]
              }
            }
          },
          "description": "Wrapper { natal: ChartInput } used by endpoints that take a base natal plus extra parameters in flat fields."
        },
        {
          "type": "object",
          "required": [
            "year"
          ],
          "properties": {
            "year": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            }
          }
        }
      ],
      "description": "Wrapper { natal: ChartInput } used by endpoints that take a base natal plus extra parameters in flat fields."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_prognostics_lunar_return

Find the next date when the Moon returns to its natal longitude. Returns full lunar return chart. [Group: Prognostics] [Endpoint: POST /v1/lunar-return] [Cost: 50 credits (Tier 3)]

read-only

Argument	Type	Description
body*	any	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "allOf": [
        {
          "type": "object",
          "required": [
            "date",
            "time",
            "latitude",
            "longitude"
          ],
          "properties": {
            "city": {
              "type": "string",
              "default": ""
            },
            "date": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "name": {
              "type": "string",
              "default": ""
            },
            "time": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "ayanamsa": {
              "enum": [
                "fagan-bradley",
                "lahiri",
                "de-luce",
                "raman",
                "krishnamurti",
                "kp",
                "yukteshwar",
                "jn-bhasin",
                "true-citra",
                "djwhal-khul"
              ],
              "type": "string",
              "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
            },
            "latitude": {
              "type": "number",
              "maximum": 90,
              "minimum": -90
            },
            "timezone": {
              "type": "string",
              "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
            },
            "cosmogram": {
              "type": "boolean"
            },
            "longitude": {
              "type": "number",
              "maximum": 180,
              "minimum": -180
            },
            "ayanamsaId": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "zodiacType": {
              "enum": [
                "tropical",
                "sidereal"
              ],
              "type": "string"
            },
            "houseSystem": {
              "enum": [
                "P",
                "K",
                "R",
                "C",
                "E",
                "W",
                "B",
                "M",
                "O",
                "A",
                "T",
                "V",
                "D",
                "F",
                "G",
                "H",
                "I",
                "i",
                "L",
                "N",
                "Q",
                "S",
                "U",
                "X",
                "Y"
              ],
              "type": "string",
              "default": "P"
            },
            "timezoneOffset": {
              "anyOf": [
                {
                  "type": "number",
                  "maximum": 14,
                  "minimum": -14
                },
                {
                  "type": "null"
                }
              ],
              "default": 0,
              "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
            }
          },
          "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        },
        {
          "type": "object",
          "required": [
            "afterDate"
          ],
          "properties": {
            "afterDate": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "afterTime": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "locationLat": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "locationLng": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "afterTzOffset": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        }
      ],
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_prognostics_minor_progressions

Calculate minor progressions (lunar month-for-a-year) to a target date. Supports converse direction. [Group: Prognostics] [Endpoint: POST /v1/minor-progressions] [Cost: 50 credits (Tier 3)]

read-only

Argument	Type	Description
body*	any	Natal chart plus a target date for time-based calculations: progressions, directions, profections, returns.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "allOf": [
        {
          "type": "object",
          "required": [
            "date",
            "time",
            "latitude",
            "longitude"
          ],
          "properties": {
            "city": {
              "type": "string",
              "default": ""
            },
            "date": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "name": {
              "type": "string",
              "default": ""
            },
            "time": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "ayanamsa": {
              "enum": [
                "fagan-bradley",
                "lahiri",
                "de-luce",
                "raman",
                "krishnamurti",
                "kp",
                "yukteshwar",
                "jn-bhasin",
                "true-citra",
                "djwhal-khul"
              ],
              "type": "string",
              "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
            },
            "latitude": {
              "type": "number",
              "maximum": 90,
              "minimum": -90
            },
            "timezone": {
              "type": "string",
              "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
            },
            "cosmogram": {
              "type": "boolean"
            },
            "longitude": {
              "type": "number",
              "maximum": 180,
              "minimum": -180
            },
            "ayanamsaId": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "zodiacType": {
              "enum": [
                "tropical",
                "sidereal"
              ],
              "type": "string"
            },
            "houseSystem": {
              "enum": [
                "P",
                "K",
                "R",
                "C",
                "E",
                "W",
                "B",
                "M",
                "O",
                "A",
                "T",
                "V",
                "D",
                "F",
                "G",
                "H",
                "I",
                "i",
                "L",
                "N",
                "Q",
                "S",
                "U",
                "X",
                "Y"
              ],
              "type": "string",
              "default": "P"
            },
            "timezoneOffset": {
              "anyOf": [
                {
                  "type": "number",
                  "maximum": 14,
                  "minimum": -14
                },
                {
                  "type": "null"
                }
              ],
              "default": 0,
              "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
            }
          },
          "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        },
        {
          "type": "object",
          "required": [
            "targetDate"
          ],
          "properties": {
            "converse": {
              "type": "boolean"
            },
            "targetDate": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "targetTime": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "targetTzOffset": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        }
      ],
      "description": "Natal chart plus a target date for time-based calculations: progressions, directions, profections, returns."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_prognostics_planetary_return

Find all returns of any planet to its natal longitude within a given year. Returns full charts for each return. [Group: Prognostics] [Endpoint: POST /v1/planetary-return] [Cost: 50 credits (Tier 3)]

read-only

Argument	Type	Description
body*	any	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "allOf": [
        {
          "type": "object",
          "required": [
            "date",
            "time",
            "latitude",
            "longitude"
          ],
          "properties": {
            "city": {
              "type": "string",
              "default": ""
            },
            "date": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "name": {
              "type": "string",
              "default": ""
            },
            "time": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "ayanamsa": {
              "enum": [
                "fagan-bradley",
                "lahiri",
                "de-luce",
                "raman",
                "krishnamurti",
                "kp",
                "yukteshwar",
                "jn-bhasin",
                "true-citra",
                "djwhal-khul"
              ],
              "type": "string",
              "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
            },
            "latitude": {
              "type": "number",
              "maximum": 90,
              "minimum": -90
            },
            "timezone": {
              "type": "string",
              "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
            },
            "cosmogram": {
              "type": "boolean"
            },
            "longitude": {
              "type": "number",
              "maximum": 180,
              "minimum": -180
            },
            "ayanamsaId": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "zodiacType": {
              "enum": [
                "tropical",
                "sidereal"
              ],
              "type": "string"
            },
            "houseSystem": {
              "enum": [
                "P",
                "K",
                "R",
                "C",
                "E",
                "W",
                "B",
                "M",
                "O",
                "A",
                "T",
                "V",
                "D",
                "F",
                "G",
                "H",
                "I",
                "i",
                "L",
                "N",
                "Q",
                "S",
                "U",
                "X",
                "Y"
              ],
              "type": "string",
              "default": "P"
            },
            "timezoneOffset": {
              "anyOf": [
                {
                  "type": "number",
                  "maximum": 14,
                  "minimum": -14
                },
                {
                  "type": "null"
                }
              ],
              "default": 0,
              "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
            }
          },
          "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        },
        {
          "type": "object",
          "required": [
            "planetId",
            "year"
          ],
          "properties": {
            "year": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "planetId": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "locationLat": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "locationLng": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        }
      ],
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_prognostics_primary_directions

Calculate primary directions (Ptolemaic or Regiomontanus) up to a maximum age. Returns a timeline of directed aspect hits. [Group: Prognostics] [Endpoint: POST /v1/primary-directions] [Cost: 50 credits (Tier 3)]

read-only

Argument	Type	Description
body*	any	Natal chart plus the directional rate in degrees per year (Naibod 0.9856353 by default), the age to search to, and the aspect angles to test.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "allOf": [
        {
          "type": "object",
          "required": [
            "date",
            "time",
            "latitude",
            "longitude"
          ],
          "properties": {
            "city": {
              "type": "string",
              "default": ""
            },
            "date": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "name": {
              "type": "string",
              "default": ""
            },
            "time": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "ayanamsa": {
              "enum": [
                "fagan-bradley",
                "lahiri",
                "de-luce",
                "raman",
                "krishnamurti",
                "kp",
                "yukteshwar",
                "jn-bhasin",
                "true-citra",
                "djwhal-khul"
              ],
              "type": "string",
              "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
            },
            "latitude": {
              "type": "number",
              "maximum": 90,
              "minimum": -90
            },
            "timezone": {
              "type": "string",
              "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
            },
            "cosmogram": {
              "type": "boolean"
            },
            "longitude": {
              "type": "number",
              "maximum": 180,
              "minimum": -180
            },
            "ayanamsaId": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "zodiacType": {
              "enum": [
                "tropical",
                "sidereal"
              ],
              "type": "string"
            },
            "houseSystem": {
              "enum": [
                "P",
                "K",
                "R",
                "C",
                "E",
                "W",
                "B",
                "M",
                "O",
                "A",
                "T",
                "V",
                "D",
                "F",
                "G",
                "H",
                "I",
                "i",
                "L",
                "N",
                "Q",
                "S",
                "U",
                "X",
                "Y"
              ],
              "type": "string",
              "default": "P"
            },
            "timezoneOffset": {
              "anyOf": [
                {
                  "type": "number",
                  "maximum": 14,
                  "minimum": -14
                },
                {
                  "type": "null"
                }
              ],
              "default": 0,
              "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
            }
          },
          "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        },
        {
          "type": "object",
          "properties": {
            "key": {
              "type": "number",
              "maximum": 2,
              "exclusiveMinimum": 0
            },
            "maxAge": {
              "type": "integer",
              "maximum": 120,
              "exclusiveMinimum": 0
            },
            "aspectAngles": {
              "type": "array",
              "items": {
                "anyOf": [
                  {
                    "type": "number",
                    "maximum": 180,
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "maxItems": 64
            }
          },
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        }
      ],
      "description": "Natal chart plus the directional rate in degrees per year (Naibod 0.9856353 by default), the age to search to, and the aspect angles to test."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_prognostics_profections

Calculate annual profections: profected Ascendant, lord of the year, activated house, and monthly profection sub-rulers. [Group: Prognostics] [Endpoint: POST /v1/profections] [Cost: 20 credits (Tier 2)]

read-only

Argument	Type	Description
body*	any	Natal chart plus a target date for time-based calculations: progressions, directions, profections, returns.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "allOf": [
        {
          "type": "object",
          "required": [
            "date",
            "time",
            "latitude",
            "longitude"
          ],
          "properties": {
            "city": {
              "type": "string",
              "default": ""
            },
            "date": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "name": {
              "type": "string",
              "default": ""
            },
            "time": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "ayanamsa": {
              "enum": [
                "fagan-bradley",
                "lahiri",
                "de-luce",
                "raman",
                "krishnamurti",
                "kp",
                "yukteshwar",
                "jn-bhasin",
                "true-citra",
                "djwhal-khul"
              ],
              "type": "string",
              "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
            },
            "latitude": {
              "type": "number",
              "maximum": 90,
              "minimum": -90
            },
            "timezone": {
              "type": "string",
              "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
            },
            "cosmogram": {
              "type": "boolean"
            },
            "longitude": {
              "type": "number",
              "maximum": 180,
              "minimum": -180
            },
            "ayanamsaId": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "zodiacType": {
              "enum": [
                "tropical",
                "sidereal"
              ],
              "type": "string"
            },
            "houseSystem": {
              "enum": [
                "P",
                "K",
                "R",
                "C",
                "E",
                "W",
                "B",
                "M",
                "O",
                "A",
                "T",
                "V",
                "D",
                "F",
                "G",
                "H",
                "I",
                "i",
                "L",
                "N",
                "Q",
                "S",
                "U",
                "X",
                "Y"
              ],
              "type": "string",
              "default": "P"
            },
            "timezoneOffset": {
              "anyOf": [
                {
                  "type": "number",
                  "maximum": 14,
                  "minimum": -14
                },
                {
                  "type": "null"
                }
              ],
              "default": 0,
              "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
            }
          },
          "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        },
        {
          "type": "object",
          "required": [
            "targetDate"
          ],
          "properties": {
            "converse": {
              "type": "boolean"
            },
            "targetDate": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "targetTime": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "targetTzOffset": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        }
      ],
      "description": "Natal chart plus a target date for time-based calculations: progressions, directions, profections, returns."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_prognostics_progressions

Calculate secondary progressed chart (day-for-a-year) for a target date. Returns progressed planets, houses and angles, and the aspects between progressed planets. [Group: Prognostics] [Endpoint: POST /v1/progressions] [Cost: 50 credits (Tier 3)]

read-only

Argument	Type	Description
body*	any	Natal chart plus a target date for time-based calculations: progressions, directions, profections, returns.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "allOf": [
        {
          "type": "object",
          "required": [
            "date",
            "time",
            "latitude",
            "longitude"
          ],
          "properties": {
            "city": {
              "type": "string",
              "default": ""
            },
            "date": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "name": {
              "type": "string",
              "default": ""
            },
            "time": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "ayanamsa": {
              "enum": [
                "fagan-bradley",
                "lahiri",
                "de-luce",
                "raman",
                "krishnamurti",
                "kp",
                "yukteshwar",
                "jn-bhasin",
                "true-citra",
                "djwhal-khul"
              ],
              "type": "string",
              "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
            },
            "latitude": {
              "type": "number",
              "maximum": 90,
              "minimum": -90
            },
            "timezone": {
              "type": "string",
              "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
            },
            "cosmogram": {
              "type": "boolean"
            },
            "longitude": {
              "type": "number",
              "maximum": 180,
              "minimum": -180
            },
            "ayanamsaId": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "zodiacType": {
              "enum": [
                "tropical",
                "sidereal"
              ],
              "type": "string"
            },
            "houseSystem": {
              "enum": [
                "P",
                "K",
                "R",
                "C",
                "E",
                "W",
                "B",
                "M",
                "O",
                "A",
                "T",
                "V",
                "D",
                "F",
                "G",
                "H",
                "I",
                "i",
                "L",
                "N",
                "Q",
                "S",
                "U",
                "X",
                "Y"
              ],
              "type": "string",
              "default": "P"
            },
            "timezoneOffset": {
              "anyOf": [
                {
                  "type": "number",
                  "maximum": 14,
                  "minimum": -14
                },
                {
                  "type": "null"
                }
              ],
              "default": 0,
              "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
            }
          },
          "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        },
        {
          "type": "object",
          "required": [
            "targetDate"
          ],
          "properties": {
            "converse": {
              "type": "boolean"
            },
            "targetDate": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "targetTime": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "targetTzOffset": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        }
      ],
      "description": "Natal chart plus a target date for time-based calculations: progressions, directions, profections, returns."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_prognostics_rectification

Rectify an approximate birth time using a list of life events and transit/direction hits to narrow the birth time window. [Group: Prognostics] [Endpoint: POST /v1/rectification] [Required: baseInput, events] [Cost: 500 credits (Tier 6)] ⚠️ Heavy — confirm with user before invoking.

read-only

Argument	Type	Description
orb	number
events*	array
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
methods	object
baseInput*	object	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
precision

astroway_prognostics_rectification_trutine

Apply the Trutine of Hermes (Animodar) technique to derive the birth time from the Moon's prenatal syzygy position. [Group: Prognostics] [Endpoint: POST /v1/rectification/trutine] [Required: date, time, latitude, longitude] [Cost: 250 credits (Tier 5)] ⚠️ Heavy — confirm with user before invoking.

read-only

Argument	Type	Description
city	string
date*	string
name	string
time*	string
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
ayanamsa	string	Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
latitude*	number
timezone	string	IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.

astroway_prognostics_solar_return

Find the exact moment when the Sun returns to its natal longitude in a given year. Returns full solar return chart. [Group: Prognostics] [Endpoint: POST /v1/solar-return] [Cost: 50 credits (Tier 3)]

read-only

Argument	Type	Description
body*	any	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "allOf": [
        {
          "type": "object",
          "required": [
            "date",
            "time",
            "latitude",
            "longitude"
          ],
          "properties": {
            "city": {
              "type": "string",
              "default": ""
            },
            "date": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "name": {
              "type": "string",
              "default": ""
            },
            "time": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "ayanamsa": {
              "enum": [
                "fagan-bradley",
                "lahiri",
                "de-luce",
                "raman",
                "krishnamurti",
                "kp",
                "yukteshwar",
                "jn-bhasin",
                "true-citra",
                "djwhal-khul"
              ],
              "type": "string",
              "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
            },
            "latitude": {
              "type": "number",
              "maximum": 90,
              "minimum": -90
            },
            "timezone": {
              "type": "string",
              "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
            },
            "cosmogram": {
              "type": "boolean"
            },
            "longitude": {
              "type": "number",
              "maximum": 180,
              "minimum": -180
            },
            "ayanamsaId": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "zodiacType": {
              "enum": [
                "tropical",
                "sidereal"
              ],
              "type": "string"
            },
            "houseSystem": {
              "enum": [
                "P",
                "K",
                "R",
                "C",
                "E",
                "W",
                "B",
                "M",
                "O",
                "A",
                "T",
                "V",
                "D",
                "F",
                "G",
                "H",
                "I",
                "i",
                "L",
                "N",
                "Q",
                "S",
                "U",
                "X",
                "Y"
              ],
              "type": "string",
              "default": "P"
            },
            "timezoneOffset": {
              "anyOf": [
                {
                  "type": "number",
                  "maximum": 14,
                  "minimum": -14
                },
                {
                  "type": "null"
                }
              ],
              "default": 0,
              "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
            }
          },
          "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        },
        {
          "type": "object",
          "required": [
            "year"
          ],
          "properties": {
            "year": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "locationLat": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "locationLng": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        }
      ],
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_prognostics_symbolic_directions

Calculate symbolic arc directions to natal points for a target date. Key: "one_degree" (default), "naibod", or "solar_arc" (the arc of the progressed Sun). [Group: Prognostics] [Endpoint: POST /v1/symbolic-directions] [Cost: 50 credits (Tier 3)]

read-only

Argument	Type	Description
body*	any	Natal chart plus a target date and the directional key: one degree per year, the Naibod rate, or the arc of the progressed Sun.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "allOf": [
        {
          "allOf": [
            {
              "type": "object",
              "required": [
                "date",
                "time",
                "latitude",
                "longitude"
              ],
              "properties": {
                "city": {
                  "type": "string",
                  "default": ""
                },
                "date": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                },
                "name": {
                  "type": "string",
                  "default": ""
                },
                "time": {
                  "type": "string",
                  "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
                },
                "ayanamsa": {
                  "enum": [
                    "fagan-bradley",
                    "lahiri",
                    "de-luce",
                    "raman",
                    "krishnamurti",
                    "kp",
                    "yukteshwar",
                    "jn-bhasin",
                    "true-citra",
                    "djwhal-khul"
                  ],
                  "type": "string",
                  "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
                },
                "latitude": {
                  "type": "number",
                  "maximum": 90,
                  "minimum": -90
                },
                "timezone": {
                  "type": "string",
                  "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
                },
                "cosmogram": {
                  "type": "boolean"
                },
                "longitude": {
                  "type": "number",
                  "maximum": 180,
                  "minimum": -180
                },
                "ayanamsaId": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "zodiacType": {
                  "enum": [
                    "tropical",
                    "sidereal"
                  ],
                  "type": "string"
                },
                "houseSystem": {
                  "enum": [
                    "P",
                    "K",
                    "R",
                    "C",
                    "E",
                    "W",
                    "B",
                    "M",
                    "O",
                    "A",
                    "T",
                    "V",
                    "D",
                    "F",
                    "G",
                    "H",
                    "I",
                    "i",
                    "L",
                    "N",
                    "Q",
                    "S",
                    "U",
                    "X",
                    "Y"
                  ],
                  "type": "string",
                  "default": "P"
                },
                "timezoneOffset": {
                  "anyOf": [
                    {
                      "type": "number",
                      "maximum": 14,
                      "minimum": -14
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": 0,
                  "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
                }
              },
              "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
              "additionalProperties": {
                "anyOf": [
                  {},
                  {
                    "type": "null"
                  }
                ]
              }
            },
            {
              "type": "object",
              "required": [
                "targetDate"
              ],
              "properties": {
                "converse": {
                  "type": "boolean"
                },
                "targetDate": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                },
                "targetTime": {
                  "type": "string",
                  "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
                },
                "targetTzOffset": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "additionalProperties": {
                "anyOf": [
                  {},
                  {
                    "type": "null"
                  }
                ]
              }
            }
          ],
          "description": "Natal chart plus a target date for time-based calculations: progressions, directions, profections, returns."
        },
        {
          "type": "object",
          "properties": {
            "key": {
              "enum": [
                "one_degree",
                "naibod",
                "solar_arc"
              ],
              "type": "string"
            }
          },
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        }
      ],
      "description": "Natal chart plus a target date and the directional key: one degree per year, the Naibod rate, or the arc of the progressed Sun."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_prognostics_tertiary_progressions

Calculate tertiary progressions (day-for-a-lunar-month) to a target date. Supports converse direction. [Group: Prognostics] [Endpoint: POST /v1/tertiary-progressions] [Cost: 50 credits (Tier 3)]

read-only

Argument	Type	Description
body*	any	Natal chart plus a target date for time-based calculations: progressions, directions, profections, returns.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "allOf": [
        {
          "type": "object",
          "required": [
            "date",
            "time",
            "latitude",
            "longitude"
          ],
          "properties": {
            "city": {
              "type": "string",
              "default": ""
            },
            "date": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "name": {
              "type": "string",
              "default": ""
            },
            "time": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "ayanamsa": {
              "enum": [
                "fagan-bradley",
                "lahiri",
                "de-luce",
                "raman",
                "krishnamurti",
                "kp",
                "yukteshwar",
                "jn-bhasin",
                "true-citra",
                "djwhal-khul"
              ],
              "type": "string",
              "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
            },
            "latitude": {
              "type": "number",
              "maximum": 90,
              "minimum": -90
            },
            "timezone": {
              "type": "string",
              "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
            },
            "cosmogram": {
              "type": "boolean"
            },
            "longitude": {
              "type": "number",
              "maximum": 180,
              "minimum": -180
            },
            "ayanamsaId": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "zodiacType": {
              "enum": [
                "tropical",
                "sidereal"
              ],
              "type": "string"
            },
            "houseSystem": {
              "enum": [
                "P",
                "K",
                "R",
                "C",
                "E",
                "W",
                "B",
                "M",
                "O",
                "A",
                "T",
                "V",
                "D",
                "F",
                "G",
                "H",
                "I",
                "i",
                "L",
                "N",
                "Q",
                "S",
                "U",
                "X",
                "Y"
              ],
              "type": "string",
              "default": "P"
            },
            "timezoneOffset": {
              "anyOf": [
                {
                  "type": "number",
                  "maximum": 14,
                  "minimum": -14
                },
                {
                  "type": "null"
                }
              ],
              "default": 0,
              "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
            }
          },
          "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        },
        {
          "type": "object",
          "required": [
            "targetDate"
          ],
          "properties": {
            "converse": {
              "type": "boolean"
            },
            "targetDate": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "targetTime": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "targetTzOffset": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        }
      ],
      "description": "Natal chart plus a target date for time-based calculations: progressions, directions, profections, returns."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_prognostics_transit_calendar

List the exact moments of transit-to-natal aspects in a date range, one event per exact pass, so a retrograde triple pass gives three events. [Group: Prognostics] [Endpoint: POST /v1/transit-calendar] [Cost: 100 credits (Tier 4)]

read-only

Argument	Type	Description
body*	any	Wrapper { natal: ChartInput } used by endpoints that take a base natal plus extra parameters in flat fields.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "allOf": [
        {
          "type": "object",
          "required": [
            "natal"
          ],
          "properties": {
            "natal": {
              "type": "object",
              "required": [
                "date",
                "time",
                "latitude",
                "longitude"
              ],
              "properties": {
                "city": {
                  "type": "string",
                  "default": ""
                },
                "date": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                },
                "name": {
                  "type": "string",
                  "default": ""
                },
                "time": {
                  "type": "string",
                  "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
                },
                "ayanamsa": {
                  "enum": [
                    "fagan-bradley",
                    "lahiri",
                    "de-luce",
                    "raman",
                    "krishnamurti",
                    "kp",
                    "yukteshwar",
                    "jn-bhasin",
                    "true-citra",
                    "djwhal-khul"
                  ],
                  "type": "string",
                  "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
                },
                "latitude": {
                  "type": "number",
                  "maximum": 90,
                  "minimum": -90
                },
                "timezone": {
                  "type": "string",
                  "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
                },
                "cosmogram": {
                  "type": "boolean"
                },
                "longitude": {
                  "type": "number",
                  "maximum": 180,
                  "minimum": -180
                },
                "ayanamsaId": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "zodiacType": {
                  "enum": [
                    "tropical",
                    "sidereal"
                  ],
                  "type": "string"
                },
                "houseSystem": {
                  "enum": [
                    "P",
                    "K",
                    "R",
                    "C",
                    "E",
                    "W",
                    "B",
                    "M",
                    "O",
                    "A",
                    "T",
                    "V",
                    "D",
                    "F",
                    "G",
                    "H",
                    "I",
                    "i",
                    "L",
                    "N",
                    "Q",
                    "S",
                    "U",
                    "X",
                    "Y"
                  ],
                  "type": "string",
                  "default": "P"
                },
                "timezoneOffset": {
                  "anyOf": [
                    {
                      "type": "number",
                      "maximum": 14,
                      "minimum": -14
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": 0,
                  "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
                }
              },
              "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
              "additionalProperties": {
                "anyOf": [
                  {},
                  {
                    "type": "null"
                  }
                ]
              }
            }
          },
          "description": "Wrapper { natal: ChartInput } used by endpoints that take a base natal plus extra parameters in flat fields."
        },
        {
          "type": "object",
          "required": [
            "startDate",
            "endDate"
          ],
          "properties": {
            "maxOrb": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Accepted and echoed back, but it does not filter anything: every event is an exact hit, found by the sign change of the offset and refined by bisection, so its orb is 0. Must be in (0, 10] if sent."
            },
            "endDate": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "startDate": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "aspectAngles": {
              "type": "array",
              "items": {
                "anyOf": [
                  {
                    "type": "number",
                    "maximum": 360,
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "maxItems": 64,
              "description": "Subset of 0, 60, 90, 120, 180 (the default is all five). Other angles match nothing and answer 400."
            },
            "transitPlanetIds": {
              "type": "array",
              "items": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "maxItems": 32,
              "description": "Transiting bodies, ids 0 and 2-9 (Sun, Mercury to Pluto; the Moon is excluded). Default: all nine."
            }
          }
        }
      ],
      "description": "Wrapper { natal: ChartInput } used by endpoints that take a base natal plus extra parameters in flat fields."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

astroway_prognostics_transits

Calculate transit planet aspects to natal planets for a given date. Returns applying and separating aspects. [Group: Prognostics] [Endpoint: POST /v1/transits] [Cost: 50 credits (Tier 3)]

read-only

Argument	Type	Description
body*	any	Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.
fields	string	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precision	integer	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "allOf": [
        {
          "type": "object",
          "required": [
            "date",
            "time",
            "latitude",
            "longitude"
          ],
          "properties": {
            "city": {
              "type": "string",
              "default": ""
            },
            "date": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "name": {
              "type": "string",
              "default": ""
            },
            "time": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "ayanamsa": {
              "enum": [
                "fagan-bradley",
                "lahiri",
                "de-luce",
                "raman",
                "krishnamurti",
                "kp",
                "yukteshwar",
                "jn-bhasin",
                "true-citra",
                "djwhal-khul"
              ],
              "type": "string",
              "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
            },
            "latitude": {
              "type": "number",
              "maximum": 90,
              "minimum": -90
            },
            "timezone": {
              "type": "string",
              "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
            },
            "cosmogram": {
              "type": "boolean"
            },
            "longitude": {
              "type": "number",
              "maximum": 180,
              "minimum": -180
            },
            "ayanamsaId": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "zodiacType": {
              "enum": [
                "tropical",
                "sidereal"
              ],
              "type": "string"
            },
            "houseSystem": {
              "enum": [
                "P",
                "K",
                "R",
                "C",
                "E",
                "W",
                "B",
                "M",
                "O",
                "A",
                "T",
                "V",
                "D",
                "F",
                "G",
                "H",
                "I",
                "i",
                "L",
                "N",
                "Q",
                "S",
                "U",
                "X",
                "Y"
              ],
              "type": "string",
              "default": "P"
            },
            "timezoneOffset": {
              "anyOf": [
                {
                  "type": "number",
                  "maximum": 14,
                  "minimum": -14
                },
                {
                  "type": "null"
                }
              ],
              "default": 0,
              "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
            }
          },
          "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        },
        {
          "type": "object",
          "required": [
            "transitDate"
          ],
          "properties": {
            "transitDate": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "transitTime": {
              "type": "string",
              "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
            },
            "transitTzOffset": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "additionalProperties": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          }
        }
      ],
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems."
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "withTnp": {
      "type": "boolean"
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "withTnp": {
      "type": "boolean"
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "withTnp": {
      "type": "boolean"
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "withTnp": {
      "type": "boolean"
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "withTnp": {
      "type": "boolean"
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "withTnp": {
      "type": "boolean"
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "withTnp": {
      "type": "boolean"
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude",
    "targetDate"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "withTnp": {
      "type": "boolean"
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "converse": {
      "type": "boolean"
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "targetDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "targetTime": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "targetTzOffset": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "withTnp": {
      "type": "boolean"
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "topic",
    "agentA",
    "agentB"
  ],
  "properties": {
    "chart": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "city": {
          "type": "string",
          "default": ""
        },
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "name": {
          "type": "string",
          "default": ""
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
        },
        "ayanamsa": {
          "enum": [
            "fagan-bradley",
            "lahiri",
            "de-luce",
            "raman",
            "krishnamurti",
            "kp",
            "yukteshwar",
            "jn-bhasin",
            "true-citra",
            "djwhal-khul"
          ],
          "type": "string",
          "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
        },
        "latitude": {
          "type": "number",
          "maximum": 90,
          "minimum": -90
        },
        "timezone": {
          "type": "string",
          "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
        },
        "cosmogram": {
          "type": "boolean"
        },
        "longitude": {
          "type": "number",
          "maximum": 180,
          "minimum": -180
        },
        "ayanamsaId": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "zodiacType": {
          "enum": [
            "tropical",
            "sidereal"
          ],
          "type": "string"
        },
        "houseSystem": {
          "enum": [
            "P",
            "K",
            "R",
            "C",
            "E",
            "W",
            "B",
            "M",
            "O",
            "A",
            "T",
            "V",
            "D",
            "F",
            "G",
            "H",
            "I",
            "i",
            "L",
            "N",
            "Q",
            "S",
            "U",
            "X",
            "Y"
          ],
          "type": "string",
          "default": "P"
        },
        "timezoneOffset": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "null"
            }
          ],
          "default": 0,
          "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
        }
      },
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
      "additionalProperties": {
        "anyOf": [
          {},
          {
            "type": "null"
          }
        ]
      }
    },
    "topic": {
      "type": "string",
      "maxLength": 800,
      "minLength": 4
    },
    "agentA": {
      "type": "string"
    },
    "agentB": {
      "type": "string"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "rounds": {
      "type": "integer",
      "default": 2,
      "maximum": 4,
      "minimum": 1
    },
    "language": {
      "enum": [
        "uk",
        "en",
        "ru",
        "es",
        "pl",
        "de",
        "fr",
        "it",
        "pt"
      ],
      "type": "string",
      "default": "en"
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "message"
  ],
  "properties": {
    "chart": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "city": {
          "type": "string",
          "default": ""
        },
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "name": {
          "type": "string",
          "default": ""
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
        },
        "ayanamsa": {
          "enum": [
            "fagan-bradley",
            "lahiri",
            "de-luce",
            "raman",
            "krishnamurti",
            "kp",
            "yukteshwar",
            "jn-bhasin",
            "true-citra",
            "djwhal-khul"
          ],
          "type": "string",
          "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
        },
        "latitude": {
          "type": "number",
          "maximum": 90,
          "minimum": -90
        },
        "timezone": {
          "type": "string",
          "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
        },
        "cosmogram": {
          "type": "boolean"
        },
        "longitude": {
          "type": "number",
          "maximum": 180,
          "minimum": -180
        },
        "ayanamsaId": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "zodiacType": {
          "enum": [
            "tropical",
            "sidereal"
          ],
          "type": "string"
        },
        "houseSystem": {
          "enum": [
            "P",
            "K",
            "R",
            "C",
            "E",
            "W",
            "B",
            "M",
            "O",
            "A",
            "T",
            "V",
            "D",
            "F",
            "G",
            "H",
            "I",
            "i",
            "L",
            "N",
            "Q",
            "S",
            "U",
            "X",
            "Y"
          ],
          "type": "string",
          "default": "P"
        },
        "timezoneOffset": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "null"
            }
          ],
          "default": 0,
          "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
        }
      },
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
      "additionalProperties": {
        "anyOf": [
          {},
          {
            "type": "null"
          }
        ]
      }
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "history": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "role",
          "content"
        ],
        "properties": {
          "role": {
            "enum": [
              "user",
              "assistant"
            ],
            "type": "string"
          },
          "content": {
            "type": "string",
            "maxLength": 2000
          }
        }
      },
      "maxItems": 10
    },
    "message": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 2
    },
    "persona": {
      "enum": [
        "astrologer",
        "plain",
        "coach",
        "teacher"
      ],
      "type": "string",
      "default": "astrologer"
    },
    "language": {
      "enum": [
        "uk",
        "en",
        "de",
        "ru",
        "pl",
        "es",
        "pt",
        "hi",
        "fr",
        "ko",
        "it",
        "ja",
        "id",
        "tr",
        "nl",
        "ro",
        "cs",
        "vi",
        "ar",
        "el",
        "hu"
      ],
      "type": "string",
      "default": "uk"
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "chart1",
    "chart2",
    "question"
  ],
  "properties": {
    "chart1": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "city": {
          "type": "string",
          "default": ""
        },
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "name": {
          "type": "string",
          "default": ""
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
        },
        "ayanamsa": {
          "enum": [
            "fagan-bradley",
            "lahiri",
            "de-luce",
            "raman",
            "krishnamurti",
            "kp",
            "yukteshwar",
            "jn-bhasin",
            "true-citra",
            "djwhal-khul"
          ],
          "type": "string",
          "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
        },
        "latitude": {
          "type": "number",
          "maximum": 90,
          "minimum": -90
        },
        "timezone": {
          "type": "string",
          "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
        },
        "cosmogram": {
          "type": "boolean"
        },
        "longitude": {
          "type": "number",
          "maximum": 180,
          "minimum": -180
        },
        "ayanamsaId": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "zodiacType": {
          "enum": [
            "tropical",
            "sidereal"
          ],
          "type": "string"
        },
        "houseSystem": {
          "enum": [
            "P",
            "K",
            "R",
            "C",
            "E",
            "W",
            "B",
            "M",
            "O",
            "A",
            "T",
            "V",
            "D",
            "F",
            "G",
            "H",
            "I",
            "i",
            "L",
            "N",
            "Q",
            "S",
            "U",
            "X",
            "Y"
          ],
          "type": "string",
          "default": "P"
        },
        "timezoneOffset": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "null"
            }
          ],
          "default": 0,
          "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
        }
      },
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
      "additionalProperties": {
        "anyOf": [
          {},
          {
            "type": "null"
          }
        ]
      }
    },
    "chart2": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "city": {
          "type": "string",
          "default": ""
        },
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "name": {
          "type": "string",
          "default": ""
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
        },
        "ayanamsa": {
          "enum": [
            "fagan-bradley",
            "lahiri",
            "de-luce",
            "raman",
            "krishnamurti",
            "kp",
            "yukteshwar",
            "jn-bhasin",
            "true-citra",
            "djwhal-khul"
          ],
          "type": "string",
          "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
        },
        "latitude": {
          "type": "number",
          "maximum": 90,
          "minimum": -90
        },
        "timezone": {
          "type": "string",
          "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
        },
        "cosmogram": {
          "type": "boolean"
        },
        "longitude": {
          "type": "number",
          "maximum": 180,
          "minimum": -180
        },
        "ayanamsaId": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "zodiacType": {
          "enum": [
            "tropical",
            "sidereal"
          ],
          "type": "string"
        },
        "houseSystem": {
          "enum": [
            "P",
            "K",
            "R",
            "C",
            "E",
            "W",
            "B",
            "M",
            "O",
            "A",
            "T",
            "V",
            "D",
            "F",
            "G",
            "H",
            "I",
            "i",
            "L",
            "N",
            "Q",
            "S",
            "U",
            "X",
            "Y"
          ],
          "type": "string",
          "default": "P"
        },
        "timezoneOffset": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "null"
            }
          ],
          "default": 0,
          "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
        }
      },
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
      "additionalProperties": {
        "anyOf": [
          {},
          {
            "type": "null"
          }
        ]
      }
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "language": {
      "enum": [
        "uk",
        "en",
        "de",
        "ru",
        "pl",
        "es",
        "pt",
        "hi",
        "fr",
        "ko",
        "it",
        "ja",
        "id",
        "tr",
        "nl",
        "ro",
        "cs",
        "vi",
        "ar",
        "el",
        "hu"
      ],
      "type": "string",
      "default": "uk"
    },
    "question": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 5
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "planet1",
    "planet2",
    "aspectType"
  ],
  "properties": {
    "chart": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "city": {
          "type": "string",
          "default": ""
        },
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "name": {
          "type": "string",
          "default": ""
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
        },
        "ayanamsa": {
          "enum": [
            "fagan-bradley",
            "lahiri",
            "de-luce",
            "raman",
            "krishnamurti",
            "kp",
            "yukteshwar",
            "jn-bhasin",
            "true-citra",
            "djwhal-khul"
          ],
          "type": "string",
          "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
        },
        "latitude": {
          "type": "number",
          "maximum": 90,
          "minimum": -90
        },
        "timezone": {
          "type": "string",
          "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
        },
        "cosmogram": {
          "type": "boolean"
        },
        "longitude": {
          "type": "number",
          "maximum": 180,
          "minimum": -180
        },
        "ayanamsaId": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "zodiacType": {
          "enum": [
            "tropical",
            "sidereal"
          ],
          "type": "string"
        },
        "houseSystem": {
          "enum": [
            "P",
            "K",
            "R",
            "C",
            "E",
            "W",
            "B",
            "M",
            "O",
            "A",
            "T",
            "V",
            "D",
            "F",
            "G",
            "H",
            "I",
            "i",
            "L",
            "N",
            "Q",
            "S",
            "U",
            "X",
            "Y"
          ],
          "type": "string",
          "default": "P"
        },
        "timezoneOffset": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "null"
            }
          ],
          "default": 0,
          "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
        }
      },
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
      "additionalProperties": {
        "anyOf": [
          {},
          {
            "type": "null"
          }
        ]
      }
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "planet1": {
      "type": "string",
      "maxLength": 40,
      "minLength": 2
    },
    "planet2": {
      "type": "string",
      "maxLength": 40,
      "minLength": 2
    },
    "language": {
      "enum": [
        "uk",
        "en",
        "de",
        "ru",
        "pl",
        "es",
        "pt",
        "hi",
        "fr",
        "ko",
        "it",
        "ja",
        "id",
        "tr",
        "nl",
        "ro",
        "cs",
        "vi",
        "ar",
        "el",
        "hu"
      ],
      "type": "string",
      "default": "uk"
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "aspectType": {
      "enum": [
        "Conjunction",
        "Sextile",
        "Square",
        "Trine",
        "Opposition",
        "Quincunx",
        "Semi-square",
        "Sesquiquadrate"
      ],
      "type": "string"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "chart",
    "transitDate",
    "transitPlanet",
    "natalPlanet",
    "aspectType"
  ],
  "properties": {
    "chart": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "city": {
          "type": "string",
          "default": ""
        },
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "name": {
          "type": "string",
          "default": ""
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
        },
        "ayanamsa": {
          "enum": [
            "fagan-bradley",
            "lahiri",
            "de-luce",
            "raman",
            "krishnamurti",
            "kp",
            "yukteshwar",
            "jn-bhasin",
            "true-citra",
            "djwhal-khul"
          ],
          "type": "string",
          "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
        },
        "latitude": {
          "type": "number",
          "maximum": 90,
          "minimum": -90
        },
        "timezone": {
          "type": "string",
          "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
        },
        "cosmogram": {
          "type": "boolean"
        },
        "longitude": {
          "type": "number",
          "maximum": 180,
          "minimum": -180
        },
        "ayanamsaId": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "zodiacType": {
          "enum": [
            "tropical",
            "sidereal"
          ],
          "type": "string"
        },
        "houseSystem": {
          "enum": [
            "P",
            "K",
            "R",
            "C",
            "E",
            "W",
            "B",
            "M",
            "O",
            "A",
            "T",
            "V",
            "D",
            "F",
            "G",
            "H",
            "I",
            "i",
            "L",
            "N",
            "Q",
            "S",
            "U",
            "X",
            "Y"
          ],
          "type": "string",
          "default": "P"
        },
        "timezoneOffset": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "null"
            }
          ],
          "default": 0,
          "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
        }
      },
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
      "additionalProperties": {
        "anyOf": [
          {},
          {
            "type": "null"
          }
        ]
      }
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "language": {
      "enum": [
        "uk",
        "en",
        "de",
        "ru",
        "pl",
        "es",
        "pt",
        "hi",
        "fr",
        "ko",
        "it",
        "ja",
        "id",
        "tr",
        "nl",
        "ro",
        "cs",
        "vi",
        "ar",
        "el",
        "hu"
      ],
      "type": "string",
      "default": "uk"
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "aspectType": {
      "enum": [
        "Conjunction",
        "Sextile",
        "Square",
        "Trine",
        "Opposition"
      ],
      "type": "string"
    },
    "natalPlanet": {
      "type": "string",
      "maxLength": 40,
      "minLength": 2
    },
    "transitDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "transitPlanet": {
      "type": "string",
      "maxLength": 40,
      "minLength": 2
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "question",
    "agents"
  ],
  "properties": {
    "chart": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "city": {
          "type": "string",
          "default": ""
        },
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "name": {
          "type": "string",
          "default": ""
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
        },
        "ayanamsa": {
          "enum": [
            "fagan-bradley",
            "lahiri",
            "de-luce",
            "raman",
            "krishnamurti",
            "kp",
            "yukteshwar",
            "jn-bhasin",
            "true-citra",
            "djwhal-khul"
          ],
          "type": "string",
          "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
        },
        "latitude": {
          "type": "number",
          "maximum": 90,
          "minimum": -90
        },
        "timezone": {
          "type": "string",
          "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
        },
        "cosmogram": {
          "type": "boolean"
        },
        "longitude": {
          "type": "number",
          "maximum": 180,
          "minimum": -180
        },
        "ayanamsaId": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "zodiacType": {
          "enum": [
            "tropical",
            "sidereal"
          ],
          "type": "string"
        },
        "houseSystem": {
          "enum": [
            "P",
            "K",
            "R",
            "C",
            "E",
            "W",
            "B",
            "M",
            "O",
            "A",
            "T",
            "V",
            "D",
            "F",
            "G",
            "H",
            "I",
            "i",
            "L",
            "N",
            "Q",
            "S",
            "U",
            "X",
            "Y"
          ],
          "type": "string",
          "default": "P"
        },
        "timezoneOffset": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "null"
            }
          ],
          "default": 0,
          "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
        }
      },
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
      "additionalProperties": {
        "anyOf": [
          {},
          {
            "type": "null"
          }
        ]
      }
    },
    "agents": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 4,
      "minItems": 2
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "language": {
      "enum": [
        "uk",
        "en",
        "ru",
        "es",
        "pl",
        "de",
        "fr",
        "it",
        "pt"
      ],
      "type": "string",
      "default": "en"
    },
    "question": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 4
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query",
    "chart"
  ],
  "properties": {
    "topK": {
      "type": "integer",
      "default": 5,
      "maximum": 20,
      "minimum": 1
    },
    "chart": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "city": {
          "type": "string",
          "default": ""
        },
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "name": {
          "type": "string",
          "default": ""
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
        },
        "ayanamsa": {
          "enum": [
            "fagan-bradley",
            "lahiri",
            "de-luce",
            "raman",
            "krishnamurti",
            "kp",
            "yukteshwar",
            "jn-bhasin",
            "true-citra",
            "djwhal-khul"
          ],
          "type": "string",
          "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
        },
        "latitude": {
          "type": "number",
          "maximum": 90,
          "minimum": -90
        },
        "timezone": {
          "type": "string",
          "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
        },
        "cosmogram": {
          "type": "boolean"
        },
        "longitude": {
          "type": "number",
          "maximum": 180,
          "minimum": -180
        },
        "ayanamsaId": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "zodiacType": {
          "enum": [
            "tropical",
            "sidereal"
          ],
          "type": "string"
        },
        "houseSystem": {
          "enum": [
            "P",
            "K",
            "R",
            "C",
            "E",
            "W",
            "B",
            "M",
            "O",
            "A",
            "T",
            "V",
            "D",
            "F",
            "G",
            "H",
            "I",
            "i",
            "L",
            "N",
            "Q",
            "S",
            "U",
            "X",
            "Y"
          ],
          "type": "string",
          "default": "P"
        },
        "timezoneOffset": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "null"
            }
          ],
          "default": 0,
          "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
        }
      },
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
      "additionalProperties": {
        "anyOf": [
          {},
          {
            "type": "null"
          }
        ]
      }
    },
    "query": {
      "type": "string",
      "maxLength": 400,
      "minLength": 2
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "message"
  ],
  "properties": {
    "chart": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "city": {
          "type": "string",
          "default": ""
        },
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "name": {
          "type": "string",
          "default": ""
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
        },
        "ayanamsa": {
          "enum": [
            "fagan-bradley",
            "lahiri",
            "de-luce",
            "raman",
            "krishnamurti",
            "kp",
            "yukteshwar",
            "jn-bhasin",
            "true-citra",
            "djwhal-khul"
          ],
          "type": "string",
          "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
        },
        "latitude": {
          "type": "number",
          "maximum": 90,
          "minimum": -90
        },
        "timezone": {
          "type": "string",
          "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
        },
        "cosmogram": {
          "type": "boolean"
        },
        "longitude": {
          "type": "number",
          "maximum": 180,
          "minimum": -180
        },
        "ayanamsaId": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "zodiacType": {
          "enum": [
            "tropical",
            "sidereal"
          ],
          "type": "string"
        },
        "houseSystem": {
          "enum": [
            "P",
            "K",
            "R",
            "C",
            "E",
            "W",
            "B",
            "M",
            "O",
            "A",
            "T",
            "V",
            "D",
            "F",
            "G",
            "H",
            "I",
            "i",
            "L",
            "N",
            "Q",
            "S",
            "U",
            "X",
            "Y"
          ],
          "type": "string",
          "default": "P"
        },
        "timezoneOffset": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "null"
            }
          ],
          "default": 0,
          "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
        }
      },
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
      "additionalProperties": {
        "anyOf": [
          {},
          {
            "type": "null"
          }
        ]
      }
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "message": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 2
    },
    "language": {
      "enum": [
        "uk",
        "en",
        "de",
        "ru",
        "pl",
        "es",
        "pt",
        "hi",
        "fr",
        "ko",
        "it",
        "ja",
        "id",
        "tr",
        "nl",
        "ro",
        "cs",
        "vi",
        "ar",
        "el",
        "hu"
      ],
      "type": "string",
      "default": "uk"
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "baseInput",
    "events"
  ],
  "properties": {
    "orb": {
      "type": "number",
      "maximum": 15,
      "minimum": 1e-9
    },
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "date"
        ],
        "properties": {
          "date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "type": {
            "enum": [
              "marriage",
              "divorce",
              "child",
              "death_close",
              "career",
              "move",
              "illness",
              "education",
              "accident",
              "other"
            ],
            "type": "string",
            "default": "other"
          },
          "weight": {
            "type": "number",
            "default": 1,
            "maximum": 3,
            "exclusiveMinimum": 0
          },
          "description": {
            "type": "string"
          }
        }
      },
      "maxItems": 20,
      "minItems": 1
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "methods": {
      "type": "object",
      "properties": {
        "primary": {
          "type": "boolean"
        },
        "symbolic": {
          "type": "boolean"
        },
        "progression": {
          "type": "boolean"
        }
      }
    },
    "baseInput": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "city": {
          "type": "string",
          "default": ""
        },
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "name": {
          "type": "string",
          "default": ""
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
        },
        "ayanamsa": {
          "enum": [
            "fagan-bradley",
            "lahiri",
            "de-luce",
            "raman",
            "krishnamurti",
            "kp",
            "yukteshwar",
            "jn-bhasin",
            "true-citra",
            "djwhal-khul"
          ],
          "type": "string",
          "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
        },
        "latitude": {
          "type": "number",
          "maximum": 90,
          "minimum": -90
        },
        "timezone": {
          "type": "string",
          "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
        },
        "cosmogram": {
          "type": "boolean"
        },
        "longitude": {
          "type": "number",
          "maximum": 180,
          "minimum": -180
        },
        "ayanamsaId": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "zodiacType": {
          "enum": [
            "tropical",
            "sidereal"
          ],
          "type": "string"
        },
        "houseSystem": {
          "enum": [
            "P",
            "K",
            "R",
            "C",
            "E",
            "W",
            "B",
            "M",
            "O",
            "A",
            "T",
            "V",
            "D",
            "F",
            "G",
            "H",
            "I",
            "i",
            "L",
            "N",
            "Q",
            "S",
            "U",
            "X",
            "Y"
          ],
          "type": "string",
          "default": "P"
        },
        "timezoneOffset": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "null"
            }
          ],
          "default": 0,
          "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
        }
      },
      "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
      "additionalProperties": {
        "anyOf": [
          {},
          {
            "type": "null"
          }
        ]
      }
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "stepMinutes": {
      "type": "number",
      "maximum": 240,
      "minimum": 0.5
    },
    "searchRangeMinutes": {
      "type": "number",
      "maximum": 1440,
      "minimum": 1e-9
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": ""
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name": {
      "type": "string",
      "default": ""
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "fields": {
      "type": "string",
      "description": "Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. \"planets.name,planets.longitude,houses.cusp\". Omit for the whole response."
    },
    "ayanamsa": {
      "enum": [
        "fagan-bradley",
        "lahiri",
        "de-luce",
        "raman",
        "krishnamurti",
        "kp",
        "yukteshwar",
        "jn-bhasin",
        "true-citra",
        "djwhal-khul"
      ],
      "type": "string",
      "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known."
    },
    "cosmogram": {
      "type": "boolean"
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "precision": {
      "type": "integer",
      "maximum": 15,
      "minimum": 0,
      "description": "Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn."
    },
    "ayanamsaId": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "zodiacType": {
      "enum": [
        "tropical",
        "sidereal"
      ],
      "type": "string"
    },
    "houseSystem": {
      "enum": [
        "P",
        "K",
        "R",
        "C",
        "E",
        "W",
        "B",
        "M",
        "O",
        "A",
        "T",
        "V",
        "D",
        "F",
        "G",
        "H",
        "I",
        "i",
        "L",
        "N",
        "Q",
        "S",
        "U",
        "X",
        "Y"
      ],
      "type": "string",
      "default": "P"
    },
    "timezoneOffset": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
    }
  }
}