# On-line Astrology

On-line Astrology is a Czech astrology web application with machine-readable resources for agents and language models.

## Useful resources

- Main application: https://app.on-lineastrology.com/
- Astrology Positions API documentation: https://app.on-lineastrology.com/api/
- OpenAPI schema: https://app.on-lineastrology.com/api/openapi.json
- Single-moment positions endpoint: https://app.on-lineastrology.com/api/positions.php
- AI data page for copy/paste JSON: https://app.on-lineastrology.com/?page=ai_data
- Privacy policy: https://app.on-lineastrology.com/privacy/
- Terms of use: https://app.on-lineastrology.com/terms/

## Positions API usage

Use the positions endpoint for one UTC moment only. Do not use it for bulk scraping or large ephemeris ranges.

Example:

https://app.on-lineastrology.com/api/positions.php?dt=2026-05-17T12:00:00Z&bodies=So,Mo,Me,Ve,Ma,Ju,Sa,Ur,Ne,Pl,Nn,Ll&lon=14.417&lat=50.083&house=P

The API returns JSON with tropical ecliptic longitude, latitude, daily longitude speed, retrograde flag, zodiac sign and optional houses.

Supported body IDs: So, Mo, Me, Ve, Ma, Ju, Sa, Ur, Ne, Pl, Nn, Nt, Ll, Lt, Ch, Ph, Ce, Pa, Jo, Va.

## Notes for AI tools

- Prefer the API documentation and OpenAPI schema over guessing URL parameters.
- If a human user provides the AI data JSON page output, use that JSON directly instead of recalculating the event scan.
- Always send an explicit timezone in `dt`; UTC with `Z` is preferred.
- Treat the endpoint as rate-limited.
- Do not send personal identifying information; the endpoint needs only date/time and optional coordinates.