Transit Charts
Calculate current planetary transits and their aspects to natal positions.
Overview
This API provides transit functionality under the predictive tag:
- Transit chart snapshot: compute a full chart payload for a given moment.
- Transit event search: search for aspects over a time window.
POST /predictive/transit-chart
Calculate a full chart payload for a given moment (a “transit chart” snapshot). This is not a transit-event search.
Request Body
{
// Uses the enhanced chart request format.
// For transit charts, treat `subject.birth_datetime` + `subject.birth_location`
// as the moment + location you want the transit chart for.
subject: {
name: string;
birth_datetime: { iso: string };
birth_location: {
latitude: { decimal: number };
longitude: { decimal: number };
timezone: { iana_name: string };
};
};
configuration?: {
house_system?: string;
coordinate_system?: string;
coordinate_frame?: string;
zodiac_type?: string;
object_set?: string;
// ...other enhanced config fields
};
enhanced_options?: unknown;
options?: unknown;
}
Response
{
success: true;
data: unknown; // Enhanced chart payload (see OpenAPI for exact schema)
}
Example Request
curl -X POST "https://api.astromcp.io/predictive/transit-chart" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"subject": {
"name": "Transit Moment",
"birth_datetime": { "iso": "2024-12-08T12:00:00Z" },
"birth_location": {
"latitude": { "decimal": 40.7128 },
"longitude": { "decimal": -74.0060 },
"timezone": { "iana_name": "America/New_York" }
}
},
"configuration": { "house_system": "P" }
}'
Use Cases
- Daily forecasting: Snapshot the sky at a moment
- Chart rendering: Feed the result into visualization tooling
Related Endpoints
For transit event timing/search over windows, see the Predictive endpoints:
POST /predictive/transits/searchPOST /predictive/transits/planet-to-degreePOST /predictive/transits/sign-ingresses
- Predictive - Transit search, ingresses, returns
- Natal Charts - Birth chart reference