Equinox and solstice API

Give a year; get the instants of both equinoxes and both solstices, and of Earth's perihelion and aphelion with the distance, to the second in UTC. Optionally, the Sun's position day by day.

Get a free key Try it in the playground API reference

What you get

Example

curl -X POST https://astro-agent.dev/v1/astronomy/seasons -H 'Content-Type: application/json' \
  -H "X-Credits-Token: $ASTRO_AGENTS_KEY" -d '{"year":2027}'

A real answer to this request (excerpt). The same request always returns the same result_sha256, which POST https://astro-agent.dev/v1/verify recomputes for free:

{
  "endpoint": "astronomy/seasons",
  "result": {
    "seasons": [
      {
        "event": "march_equinox",
        "utc": "2027-03-20T20:24:41Z",
        "timestamp": 1805574281
      },
      {
        "event": "june_solstice",
        "utc": "2027-06-21T14:10:50Z",
        "timestamp": 1813587050
      },
      {
        "event": "september_equinox",
        "utc": "2027-09-23T06:01:43Z",
        "timestamp": 1821679303
      },
      {
        "event": "december_solstice",
        "utc": "2027-12-22T02:42:10Z",
        "timestamp": 1829443330
      }
    ],
    "perihelion": {
      "utc": "2027-01-03T02:32:55Z",
      "timestamp": 1798943575,
      "distance_km": 147104594.0,
      "distance_au": 0.983333
    }
  },
  "meta": {
    "result_sha256": "e3e81f68870ec41a74d55b4aa04cfd227701b5ccf50ea0734607c6b834880e6b"
  }
}

Routes and prices

RouteNamePrice per callWhat it returns
POST /v1/astronomy/seasonsEquinoxes, solstices, perihelion and day length over a year$0.01The year's equinoxes and solstices and Earth's perihelion and aphelion to the second; optionally the Sun day by day: sunrise, sunset, day length, solar noon, declination and equation of time.

The same routes are MCP tools on https://astro-agent.dev/mcp.

Limits

Alternatives

The US Naval Observatory API gives the seasons free for 1700-2100, perihelion and aphelion included. For those dates alone, it is the free reference.

Checked on the providers' own pages on 2026-11-20. Their terms may have changed since.

When Astro Agents fits

Get a free key Try it in the playground API reference