USNO astronomical data (Sun, Moon, eclipses, seasons) · Seasons
aa-usno-navy-mil/astronomy/seasonsGet industry and reference data with USNO astronomical data (Sun, Moon, eclipses, seasons) · Seasons from Alexandria through one Spiral API key. When does spring or winter start, what time is the equinox, when is Earth closest to the Sun. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 per call.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
year required | number 1700 to 2100 | — | Calendar year, 1700 to 2100. |
dst | true or false | — | Apply US daylight saving time rules (1967 onward) on top of tz_offset_hours. Defaults to false. USNO only knows the US rules, so for other countries pass the offset in force on the date instead. |
tz_offset_hours | number -12 to 14 | — | Hours east of Greenwich (UT offset), -12 to 14: -5 for US Eastern Standard Time, 1 for Central European Time, 5.5 for India. Defaults to 0 (UT). Times are on this fixed offset unless dst applies. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "aa-usno-navy-mil/astronomy/seasons",
"input": {
"year": 1700
}
}'Frequently asked questions
How much does USNO astronomical data (Sun, Moon, eclipses, seasons) · Seasons cost?
$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use USNO astronomical data (Sun, Moon, eclipses, seasons) · Seasons through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "aa-usno-navy-mil/astronomy/seasons"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use USNO astronomical data (Sun, Moon, eclipses, seasons) · Seasons?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use USNO astronomical data (Sun, Moon, eclipses, seasons) · Seasons?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.