{
  "schema_version": "1.0",
  "name": "astro-solar-moon",
  "display_name": "Solar & Lunar Calculator",
  "description": "Calculates precise sunrise, sunset, solar noon, civil/nautical/astronomical twilight, golden hour windows, and moon phase (illumination %, age, phase name) for any location and date. Accepts lat/lng or ZIP code. Uses embedded NOAA solar algorithm — no external API.",
  "endpoint": "https://bacapi-astro-api.workers.dev/astro",
  "method": "GET",
  "payment": {
    "protocol": "x402",
    "network":  "base",
    "currency": "USDC",
    "amount":   "0.06"
  },
  "parameters": {
    "lat":  { "type": "number", "required": false, "description": "Latitude (use with lng)" },
    "lng":  { "type": "number", "required": false, "description": "Longitude (use with lat)" },
    "zip":  { "type": "string", "required": false, "description": "5-digit US ZIP (alternative to lat/lng)" },
    "date": { "type": "string", "required": false, "description": "YYYY-MM-DD (defaults to today in UTC)" }
  },
  "response_shape": {
    "date":             "string",
    "location":         "{ lat, lng }",
    "solar": {
      "sunrise":        "ISO 8601 UTC time",
      "sunset":         "ISO 8601 UTC time",
      "solar_noon":     "ISO 8601 UTC time",
      "day_length":     "string — e.g. '14h 32m'",
      "civil_twilight": "{ dawn, dusk }",
      "nautical_twilight": "{ dawn, dusk }",
      "astronomical_twilight": "{ dawn, dusk }",
      "golden_hour":    "{ morning: { start, end }, evening: { start, end } }"
    },
    "moon": {
      "phase_name":     "string — New/Waxing Crescent/First Quarter/Waxing Gibbous/Full/Waning Gibbous/Last Quarter/Waning Crescent",
      "illumination":   "number — 0-100%",
      "age_days":       "number — days since new moon",
      "next_full_moon": "string — YYYY-MM-DD"
    }
  },
  "example_request": "GET /astro?lat=40.7128&lng=-74.0060&date=2025-06-21",
  "example_response": {
    "data": {
      "date": "2025-06-21",
      "location": { "lat": 40.7128, "lng": -74.006 },
      "solar": {
        "sunrise": "2025-06-21T09:24:00Z",
        "sunset":  "2025-06-22T00:31:00Z",
        "day_length": "15h 7m",
        "golden_hour": {
          "morning": { "start": "2025-06-21T09:24:00Z", "end": "2025-06-21T10:11:00Z" },
          "evening": { "start": "2025-06-21T23:44:00Z", "end": "2025-06-22T00:31:00Z" }
        }
      },
      "moon": {
        "phase_name":     "Waxing Gibbous",
        "illumination":   72,
        "age_days":       9.3
      }
    },
    "meta": { "priced_at": "0.06 USDC" }
  },
  "tags": ["solar","sunrise","sunset","moon","astronomy","twilight","golden-hour","agriculture","photography"],
  "category": "astronomy"
}