Sun & moon times (sunrise, golden hour, phase) API

Sunrise, sunset, solar noon, dawn/dusk, golden hour, plus moon phase and illumination for a coordinate and date (computed in-process). The astronomy is non-trivial and exact. Answers 'sunrise/sunset here', 'golden hour today', 'moon phase tonight', 'when is dusk at these coordinates'.

Price$0.01per request

MethodPOST

Route/v1/data/sun-moon

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

datasunmoonsunrisesunsetgolden-hourastronomymoon-phase

API URLhttps://x402.hexl.dev/v1/data/sun-moon

Integration docs

Example request

{
  "latitude": 40.7128,
  "longitude": -74.006
}

Example response

{
  "latitude": 40.7128,
  "longitude": -74.006,
  "date": "2026-06-03",
  "sun": {
    "sunrise": "2026-06-03T09:25:00.000Z",
    "sunset": "2026-06-04T00:23:00.000Z",
    "goldenHour": "2026-06-03T23:35:00.000Z"
  },
  "moon": {
    "phase": "waxing gibbous",
    "illumination": 0.82,
    "rise": "2026-06-03T18:40:00.000Z",
    "set": "2026-06-04T03:10:00.000Z"
  }
}

Input schema

{
  "type": "object",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "latitude": {
      "type": "number",
      "examples": [
        40.7128
      ]
    },
    "longitude": {
      "type": "number",
      "examples": [
        -74.006
      ]
    },
    "date": {
      "type": "string",
      "examples": [
        "2026-06-03"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}