Sun azimuth and elevation for any place and time, plus sunrise, solar noon, sunset, civ…
Sun azimuth and elevation for any place and time, plus sunrise, solar noon, sunset, civil to astronomical twilight, day length and polar day or night
by Saylor Innovations Knowledge Base · verified provider · updated 2026-10-26
What it does
Sun azimuth and elevation for any place and time, plus sunrise, solar noon, sunset, civil to astronomical twilight, day length and polar day or night
Tags: where is the sun right now · sun azimuth and elevation · sunrise and sunset time · golden hour or twilight time · day length on the summer
Use with an agent
- Discover. Agents find this listing with
GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP toolsearch_resources, or/discovery/resources. - Inspect. Fetch
/resources/saylorinnovations-api-astronomy-sun-position.jsonfor the price and payment options. - Pay. Call
GET https://saylorinnovations.com/api/astronomy/sun-position. The provider answers402with its payment requirements. An x402 client signs one of the options below and retries withPAYMENT-SIGNATURE. - Execute. The provider returns
200with the data. Agent Bazaar is not in the request path and never sees your payment.
For humans
You don't need an account or an API key; you need a wallet holding a small amount of USDC or USDT or SOL on Base, Polygon, Arbitrum One, Solana, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.
Pricing & payment
- Price
- $0.01 / request
- Protocol
- x402 v2
- Auth
- No account or API key. Pay per request.
- Networks
- Base, Polygon, Arbitrum One, Solana
x402 payment requirements
| Scheme | Network | Asset | Amount | Pay to | Timeout |
|---|---|---|---|---|---|
| exact | Base eip155:8453 | USDC | $0.01 | 0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa | 120s |
| exact | Polygon eip155:137 | USDC | $0.01 | 0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa | 120s |
| exact | Arbitrum One eip155:42161 | USDC | $0.01 | 0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa | 120s |
| exact | Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | USDC | $0.01 | 7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7 | 120s |
| exact | Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | USDT | $0.01 | 7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7 | 120s |
| exact | Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | SOL | $0.01 | 7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7 | 120s |
accepts[] (raw JSON)
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "eip155:137",
"payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "eip155:42161",
"payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
"asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
"asset": "So11111111111111111111111111111111111111112",
"amount": "95830",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
}
]Schemas
Output schema (JSON Schema)
{
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Latitude in decimal degrees"
},
"lon": {
"type": "number",
"description": "Longitude in decimal degrees"
},
"time": {
"type": "string",
"description": "Time"
},
"elevation_deg": {
"type": "number",
"description": "Elevation, in degrees"
},
"azimuth_deg": {
"type": "number",
"description": "Azimuth, in degrees"
},
"compass": {
"type": "string",
"description": "16-point compass direction of the sun"
},
"phase": {
"type": "string",
"description": "Sky phase: day, civil, nautical or astronomical twilight, or night"
},
"is_daylight": {
"type": "boolean",
"description": "True when this is daylight"
},
"sunrise": {
"type": [
"string",
"null"
],
"description": "Sunrise time (UTC), null in polar day or night"
},
"solar_noon": {
"type": "string",
"description": "Solar noon"
},
"sunset": {
"type": [
"string",
"null"
],
"description": "Sunset time (UTC), null in polar day or night"
},
"day_length_hours": {
"type": "number",
"description": "Day length, in hours"
},
"polar_day": {
"type": "boolean",
"description": "Polar day"
},
"polar_night": {
"type": "boolean",
"description": "Polar night"
},
"note": {
"type": "string",
"description": "Caveat or context for reading the result"
},
"source": {
"type": "string",
"description": "Data source the values come from"
},
"elevation_geometric_deg": {
"type": [
"number",
"null"
],
"description": "Elevation geometric, in degrees"
},
"declination_deg": {
"type": [
"number",
"null"
],
"description": "Declination, in degrees"
},
"equation_of_time_min": {
"type": [
"number",
"null"
],
"description": "Equation of time, in minutes"
},
"civil_dawn": {
"type": [
"string",
"null"
],
"description": "Civil dawn"
},
"civil_dusk": {
"type": [
"string",
"null"
],
"description": "Civil dusk"
},
"nautical_dawn": {
"type": [
"string",
"null"
],
"description": "Nautical dawn"
},
"nautical_dusk": {
"type": [
"string",
"null"
],
"description": "Nautical dusk"
},
"astronomical_dawn": {
"description": "Astronomical dawn"
},
"astronomical_dusk": {
"description": "Astronomical dusk"
}
},
"required": [
"lat",
"lon",
"elevation_deg",
"azimuth_deg"
]
}Example shape — generated from the schema, not a captured live response
{
"lat": 0,
"lon": 0,
"time": "string",
"elevation_deg": 0,
"azimuth_deg": 0,
"compass": "string",
"phase": "string",
"is_daylight": true,
"sunrise": "string",
"solar_noon": "string",
"sunset": "string",
"day_length_hours": 0,
"polar_day": true,
"polar_night": true,
"note": "string",
"source": "string",
"elevation_geometric_deg": 0,
"declination_deg": 0,
"equation_of_time_min": 0,
"civil_dawn": "string",
"civil_dusk": "string",
"nautical_dawn": "string",
"nautical_dusk": "string",
"astronomical_dawn": null,
"astronomical_dusk": null
}Examples
curl "https://saylorinnovations.com/api/astronomy/sun-position"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paidconst res = await fetch("https://saylorinnovations.com/api/astronomy/sun-position");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}import httpx
res = httpx.get("https://saylorinnovations.com/api/astronomy/sun-position")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerDetails
- Provider
- Saylor Innovations Knowledge Base
- Endpoint
- https://saylorinnovations.com/api/astronomy/sun-position
- Side effects
- Paid calls settle the advertised payment; see the provider contract for execution behavior.
- Machine-readable
/resources/saylorinnovations-api-astronomy-sun-position.json