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
- March and September equinoxes, June and December solstices
- Perihelion and aphelion with distance
- UTC instants and unix timestamps
- Any year from 1800 to 2200
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
| Route | Name | Price per call | What it returns |
|---|---|---|---|
POST /v1/astronomy/seasons | Equinoxes, solstices, perihelion and day length over a year | $0.01 | The 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
- Dates from 1800 to 2200; range routes take up to a year per call.
- Without a key: 1 free call on the $0.01-0.02 routes, then HTTP 402 with a pay-per-call offer (USDC, x402).
- Free key (an email, no card): 10,000 calls a month, 30 a minute, personal, research and evaluation use only. Paid plans from $19 a month by card, for commercial use: see pricing.
- Past the quota, calls answer 429 until the 1st of the month: nothing is charged beyond the plan.
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
- Calendar and education apps that use other routes too
- Years after 2100
- One key and one format for everything astronomical