{
  "$schema": "https://zodiacs.org/api/v1/schema/index.v1.json",
  "schema": "zodiacs.sky-api.index.v1",
  "source": "https://zodiacs.org/api/v1/index.json",
  "docs": "https://zodiacs.org/developers/",
  "guide": "https://zodiacs.org/api/v1/llms.txt",
  "license": "CC BY 4.0",
  "licenseUrl": "https://creativecommons.org/licenses/by/4.0/",
  "attribution": "Data: Zodiacs.org — https://zodiacs.org",
  "generatedAt": "2026-10-07T11:34:29.321Z",
  "api": "https://zodiacs.org/api/v1/",
  "summary": "Free sky data as static JSON: today's sky and the next 60 days, ten planet files, the twelve signs, and per-year retrogrades, stations, ingresses, moon phases, eclipses, and aspects for 2026–2030. CC BY 4.0, no key, open CORS. Start with https://zodiacs.org/api/v1/llms.txt.",
  "versioning": "Within v1, fields are added, never renamed or removed. A breaking change would ship under /api/v2/ and v1 would keep working.",
  "coverage": {
    "dailyDate": "2026-10-07",
    "years": {
      "from": 2026,
      "to": 2030
    },
    "dataVintage": "2026-09-30T07:54:56.476Z"
  },
  "endpoints": [
    {
      "path": "/api/v1/sky/today.json",
      "description": "Today's positions, moon phase, active retrogrades, next lunations, and exact sky events, with a plain-language summary",
      "updates": "daily, scheduled from 00:00 UTC; delivery can be delayed, so check the payload edition date",
      "schema": "https://zodiacs.org/api/v1/schema/today.v1.json"
    },
    {
      "path": "/api/v1/sky/upcoming.json",
      "description": "The next 60 days of lunations, ingresses, stations, eclipses, and exact aspects, plus the next occurrence of each kind",
      "updates": "daily, scheduled from 00:00 UTC; delivery can be delayed, so check the payload edition date",
      "schema": "https://zodiacs.org/api/v1/schema/upcoming.v1.json"
    },
    {
      "path": "/api/v1/signs.json",
      "description": "The twelve signs: element, modality, rulers, computed Sun seasons, and current occupants",
      "updates": "daily, scheduled from 00:00 UTC; delivery can be delayed, so check the payload edition date",
      "schema": "https://zodiacs.org/api/v1/schema/signs.v1.json"
    },
    {
      "path": "/api/v1/planets/sun.json",
      "description": "Sun: current position, retrograde status and windows, next ingress and station",
      "updates": "daily, scheduled from 00:00 UTC; delivery can be delayed, so check the payload edition date",
      "schema": "https://zodiacs.org/api/v1/schema/planet.v1.json"
    },
    {
      "path": "/api/v1/planets/moon.json",
      "description": "Moon: current position, retrograde status and windows, next ingress and station",
      "updates": "daily, scheduled from 00:00 UTC; delivery can be delayed, so check the payload edition date",
      "schema": "https://zodiacs.org/api/v1/schema/planet.v1.json"
    },
    {
      "path": "/api/v1/planets/mercury.json",
      "description": "Mercury: current position, retrograde status and windows, next ingress and station",
      "updates": "daily, scheduled from 00:00 UTC; delivery can be delayed, so check the payload edition date",
      "schema": "https://zodiacs.org/api/v1/schema/planet.v1.json"
    },
    {
      "path": "/api/v1/planets/venus.json",
      "description": "Venus: current position, retrograde status and windows, next ingress and station",
      "updates": "daily, scheduled from 00:00 UTC; delivery can be delayed, so check the payload edition date",
      "schema": "https://zodiacs.org/api/v1/schema/planet.v1.json"
    },
    {
      "path": "/api/v1/planets/mars.json",
      "description": "Mars: current position, retrograde status and windows, next ingress and station",
      "updates": "daily, scheduled from 00:00 UTC; delivery can be delayed, so check the payload edition date",
      "schema": "https://zodiacs.org/api/v1/schema/planet.v1.json"
    },
    {
      "path": "/api/v1/planets/jupiter.json",
      "description": "Jupiter: current position, retrograde status and windows, next ingress and station",
      "updates": "daily, scheduled from 00:00 UTC; delivery can be delayed, so check the payload edition date",
      "schema": "https://zodiacs.org/api/v1/schema/planet.v1.json"
    },
    {
      "path": "/api/v1/planets/saturn.json",
      "description": "Saturn: current position, retrograde status and windows, next ingress and station",
      "updates": "daily, scheduled from 00:00 UTC; delivery can be delayed, so check the payload edition date",
      "schema": "https://zodiacs.org/api/v1/schema/planet.v1.json"
    },
    {
      "path": "/api/v1/planets/uranus.json",
      "description": "Uranus: current position, retrograde status and windows, next ingress and station",
      "updates": "daily, scheduled from 00:00 UTC; delivery can be delayed, so check the payload edition date",
      "schema": "https://zodiacs.org/api/v1/schema/planet.v1.json"
    },
    {
      "path": "/api/v1/planets/neptune.json",
      "description": "Neptune: current position, retrograde status and windows, next ingress and station",
      "updates": "daily, scheduled from 00:00 UTC; delivery can be delayed, so check the payload edition date",
      "schema": "https://zodiacs.org/api/v1/schema/planet.v1.json"
    },
    {
      "path": "/api/v1/planets/pluto.json",
      "description": "Pluto: current position, retrograde status and windows, next ingress and station",
      "updates": "daily, scheduled from 00:00 UTC; delivery can be delayed, so check the payload edition date",
      "schema": "https://zodiacs.org/api/v1/schema/planet.v1.json"
    },
    {
      "path": "/api/v1/retrogrades/2026.json",
      "description": "Retrograde windows with stations, shadow boundaries, and clipping flags · 2026",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/retrogrades.v1.json"
    },
    {
      "path": "/api/v1/retrogrades/2027.json",
      "description": "Retrograde windows with stations, shadow boundaries, and clipping flags · 2027",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/retrogrades.v1.json"
    },
    {
      "path": "/api/v1/retrogrades/2028.json",
      "description": "Retrograde windows with stations, shadow boundaries, and clipping flags · 2028",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/retrogrades.v1.json"
    },
    {
      "path": "/api/v1/retrogrades/2029.json",
      "description": "Retrograde windows with stations, shadow boundaries, and clipping flags · 2029",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/retrogrades.v1.json"
    },
    {
      "path": "/api/v1/retrogrades/2030.json",
      "description": "Retrograde windows with stations, shadow boundaries, and clipping flags · 2030",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/retrogrades.v1.json"
    },
    {
      "path": "/api/v1/stations/2026.json",
      "description": "Every station (turning retrograde or direct) with sign and degree · 2026",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/stations.v1.json"
    },
    {
      "path": "/api/v1/stations/2027.json",
      "description": "Every station (turning retrograde or direct) with sign and degree · 2027",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/stations.v1.json"
    },
    {
      "path": "/api/v1/stations/2028.json",
      "description": "Every station (turning retrograde or direct) with sign and degree · 2028",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/stations.v1.json"
    },
    {
      "path": "/api/v1/stations/2029.json",
      "description": "Every station (turning retrograde or direct) with sign and degree · 2029",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/stations.v1.json"
    },
    {
      "path": "/api/v1/stations/2030.json",
      "description": "Every station (turning retrograde or direct) with sign and degree · 2030",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/stations.v1.json"
    },
    {
      "path": "/api/v1/ingresses/2026.json",
      "description": "Every planetary sign ingress · 2026",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/ingresses.v1.json"
    },
    {
      "path": "/api/v1/ingresses/2027.json",
      "description": "Every planetary sign ingress · 2027",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/ingresses.v1.json"
    },
    {
      "path": "/api/v1/ingresses/2028.json",
      "description": "Every planetary sign ingress · 2028",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/ingresses.v1.json"
    },
    {
      "path": "/api/v1/ingresses/2029.json",
      "description": "Every planetary sign ingress · 2029",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/ingresses.v1.json"
    },
    {
      "path": "/api/v1/ingresses/2030.json",
      "description": "Every planetary sign ingress · 2030",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/ingresses.v1.json"
    },
    {
      "path": "/api/v1/moon-phases/2026.json",
      "description": "New and full moon instants with signs and traditional names · 2026",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/moon-phases.v1.json"
    },
    {
      "path": "/api/v1/moon-phases/2027.json",
      "description": "New and full moon instants with signs and traditional names · 2027",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/moon-phases.v1.json"
    },
    {
      "path": "/api/v1/moon-phases/2028.json",
      "description": "New and full moon instants with signs and traditional names · 2028",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/moon-phases.v1.json"
    },
    {
      "path": "/api/v1/moon-phases/2029.json",
      "description": "New and full moon instants with signs and traditional names · 2029",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/moon-phases.v1.json"
    },
    {
      "path": "/api/v1/moon-phases/2030.json",
      "description": "New and full moon instants with signs and traditional names · 2030",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/moon-phases.v1.json"
    },
    {
      "path": "/api/v1/eclipses/2026.json",
      "description": "Solar and lunar eclipse peaks · 2026",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/eclipses.v1.json"
    },
    {
      "path": "/api/v1/eclipses/2027.json",
      "description": "Solar and lunar eclipse peaks · 2027",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/eclipses.v1.json"
    },
    {
      "path": "/api/v1/eclipses/2028.json",
      "description": "Solar and lunar eclipse peaks · 2028",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/eclipses.v1.json"
    },
    {
      "path": "/api/v1/eclipses/2029.json",
      "description": "Solar and lunar eclipse peaks · 2029",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/eclipses.v1.json"
    },
    {
      "path": "/api/v1/eclipses/2030.json",
      "description": "Solar and lunar eclipse peaks · 2030",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/eclipses.v1.json"
    },
    {
      "path": "/api/v1/aspects/2026.json",
      "description": "Exact planetary aspects · 2026",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/aspects.v1.json"
    },
    {
      "path": "/api/v1/aspects/2027.json",
      "description": "Exact planetary aspects · 2027",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/aspects.v1.json"
    },
    {
      "path": "/api/v1/aspects/2028.json",
      "description": "Exact planetary aspects · 2028",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/aspects.v1.json"
    },
    {
      "path": "/api/v1/aspects/2029.json",
      "description": "Exact planetary aspects · 2029",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/aspects.v1.json"
    },
    {
      "path": "/api/v1/aspects/2030.json",
      "description": "Exact planetary aspects · 2030",
      "updates": "when the underlying yearly data is refreshed",
      "schema": "https://zodiacs.org/api/v1/schema/aspects.v1.json"
    }
  ],
  "documents": [
    {
      "path": "/api/v1/llms.txt",
      "description": "The guide for AI agents: every endpoint, every field, and which file answers which question",
      "contentType": "text/plain"
    },
    {
      "path": "/api/v1/openapi.json",
      "description": "OpenAPI 3.1 description of the API with embedded JSON Schemas",
      "contentType": "application/json"
    },
    {
      "path": "/api/v1/sky/today.md",
      "description": "Today's sky rendered as Markdown",
      "contentType": "text/markdown"
    },
    {
      "path": "/api/v1/sky/upcoming.md",
      "description": "The upcoming events rendered as Markdown",
      "contentType": "text/markdown"
    },
    {
      "path": "/api/v1/schema/index.v1.json",
      "description": "JSON Schema (draft 2020-12) for zodiacs.sky-api.index.v1 payloads",
      "contentType": "application/schema+json"
    },
    {
      "path": "/api/v1/schema/today.v1.json",
      "description": "JSON Schema (draft 2020-12) for zodiacs.sky-api.today.v1 payloads",
      "contentType": "application/schema+json"
    },
    {
      "path": "/api/v1/schema/upcoming.v1.json",
      "description": "JSON Schema (draft 2020-12) for zodiacs.sky-api.upcoming.v1 payloads",
      "contentType": "application/schema+json"
    },
    {
      "path": "/api/v1/schema/retrogrades.v1.json",
      "description": "JSON Schema (draft 2020-12) for zodiacs.sky-api.retrogrades.v1 payloads",
      "contentType": "application/schema+json"
    },
    {
      "path": "/api/v1/schema/stations.v1.json",
      "description": "JSON Schema (draft 2020-12) for zodiacs.sky-api.stations.v1 payloads",
      "contentType": "application/schema+json"
    },
    {
      "path": "/api/v1/schema/ingresses.v1.json",
      "description": "JSON Schema (draft 2020-12) for zodiacs.sky-api.ingresses.v1 payloads",
      "contentType": "application/schema+json"
    },
    {
      "path": "/api/v1/schema/moon-phases.v1.json",
      "description": "JSON Schema (draft 2020-12) for zodiacs.sky-api.moon-phases.v1 payloads",
      "contentType": "application/schema+json"
    },
    {
      "path": "/api/v1/schema/eclipses.v1.json",
      "description": "JSON Schema (draft 2020-12) for zodiacs.sky-api.eclipses.v1 payloads",
      "contentType": "application/schema+json"
    },
    {
      "path": "/api/v1/schema/aspects.v1.json",
      "description": "JSON Schema (draft 2020-12) for zodiacs.sky-api.aspects.v1 payloads",
      "contentType": "application/schema+json"
    },
    {
      "path": "/api/v1/schema/planet.v1.json",
      "description": "JSON Schema (draft 2020-12) for zodiacs.sky-api.planet.v1 payloads",
      "contentType": "application/schema+json"
    },
    {
      "path": "/api/v1/schema/signs.v1.json",
      "description": "JSON Schema (draft 2020-12) for zodiacs.sky-api.signs.v1 payloads",
      "contentType": "application/schema+json"
    }
  ],
  "about": {
    "positions": "Apparent geocentric tropical ecliptic longitudes in degrees, 0–360 measured from 0° Aries.",
    "degree": "The degree field is the position within its sign, 0 to 30.",
    "position": "The position field is the same value written as degrees, minutes, and sign name, for example 14°52′ Virgo.",
    "retrograde": "retrograde is true when the body's apparent motion against the zodiac is backward at that instant. The Sun and Moon never retrograde.",
    "time": "Every instant is UTC in ISO 8601. Calendar dates are UTC dates.",
    "signs": "Signs are the twelve tropical signs as lowercase slugs (aries … pisces); signName is the English name.",
    "engine": "Positions come from the same engine as the site's calculators, tested against NASA JPL Horizons reference data at two dates, 1907 and 2020, where the largest difference is 14.8 arcseconds. Methodology: https://zodiacs.org/methodology/",
    "versioning": "Within v1, fields are added, never renamed or removed. A breaking change would ship under /api/v2/ and v1 would keep working."
  }
}