space-weather.use.x402atlas.com

{
  "additionalProperties": false,
  "properties": {
    "_atlas": {
      "additionalProperties": false,
      "description": "Atlas documentation and related-route metadata added after deployment",
      "properties": {
        "docs": {
          "description": "Documentation URL for this bridge",
          "format": "uri",
          "maxLength": 512,
          "type": "string"
        },
        "related": {
          "description": "Bounded related Atlas routes",
          "items": {
            "additionalProperties": false,
            "description": "One related Atlas route",
            "properties": {
              "bridge": {
                "description": "Related bridge name",
                "maxLength": 64,
                "type": "string"
              },
              "docs": {
                "description": "Related bridge documentation URL",
                "format": "uri",
                "maxLength": 512,
                "type": "string"
              },
              "summary": {
                "description": "Short capability summary",
                "maxLength": 256,
                "type": "string"
              },
              "url": {
                "description": "Related route URL",
                "format": "uri",
                "maxLength": 512,
                "type": "string"
              }
            },
            "required": [
              "bridge",
              "url",
              "docs",
              "summary"
            ],
            "type": "object"
          },
          "maxItems": 3,
          "type": "array"
        }
      },
      "required": [
        "docs"
      ],
      "type": "object"
    },
    "kp": {
      "additionalProperties": false,
      "description": "Required planetary K-index observation controlling route freshness",
      "properties": {
        "estimated_kp": {
          "additionalProperties": false,
          "description": "Dimensionless estimated planetary K index",
          "properties": {
            "observed_at": {
              "description": "Official source observation time",
              "format": "date-time",
              "type": "string"
            },
            "source_field": {
              "description": "Exact NOAA SWPC source field",
              "type": "string"
            },
            "unit": {
              "description": "Physical or dimensionless unit",
              "type": "string"
            },
            "value": {
              "description": "Normalized numeric observation",
              "type": "number"
            }
          },
          "required": [
            "value",
            "unit",
            "observed_at",
            "source_field"
          ],
          "type": "object"
        },
        "kp_index": {
          "description": "Source integer Kp index when present",
          "maximum": 9,
          "minimum": 0,
          "type": "integer"
        },
        "text": {
          "description": "Source textual Kp representation when present",
          "type": "string"
        }
      },
      "required": [
        "estimated_kp"
      ],
      "type": "object"
    },
    "magnetic": {
      "additionalProperties": false,
      "description": "Fresh interplanetary magnetic observations, or null with a warning",
      "properties": {
        "bt": {
          "additionalProperties": false,
          "description": "Total interplanetary magnetic field",
          "properties": {
            "observed_at": {
              "description": "Official source observation time",
              "format": "date-time",
              "type": "string"
            },
            "source_field": {
              "description": "Exact NOAA SWPC source field",
              "type": "string"
            },
            "unit": {
              "description": "Physical or dimensionless unit",
              "type": "string"
            },
            "value": {
              "description": "Normalized numeric observation",
              "type": "number"
            }
          },
          "required": [
            "value",
            "unit",
            "observed_at",
            "source_field"
          ],
          "type": "object"
        },
        "bz_gsm": {
          "additionalProperties": false,
          "description": "GSM z component of interplanetary magnetic field",
          "properties": {
            "observed_at": {
              "description": "Official source observation time",
              "format": "date-time",
              "type": "string"
            },
            "source_field": {
              "description": "Exact NOAA SWPC source field",
              "type": "string"
            },
            "unit": {
              "description": "Physical or dimensionless unit",
              "type": "string"
            },
            "value": {
              "description": "Normalized numeric observation",
              "type": "number"
            }
          },
          "required": [
            "value",
            "unit",
            "observed_at",
            "source_field"
          ],
          "type": "object"
        },
        "overall_quality": {
          "description": "Unmodified SWPC quality code",
          "type": "integer"
        },
        "source": {
          "description": "SWPC spacecraft/data source",
          "type": "string"
        }
      },
      "required": [
        "bt",
        "bz_gsm",
        "source",
        "overall_quality"
      ],
      "type": [
        "object",
        "null"
      ]
    },
    "operation": {
      "const": "current-conditions",
      "description": "Stable route operation",
      "type": "string"
    },
    "plasma": {
      "additionalProperties": false,
      "description": "Fresh solar-wind plasma observations, or null with a warning",
      "properties": {
        "overall_quality": {
          "description": "Unmodified SWPC quality code",
          "type": "integer"
        },
        "proton_density": {
          "additionalProperties": false,
          "description": "Solar-wind proton density",
          "properties": {
            "observed_at": {
              "description": "Official source observation time",
              "format": "date-time",
              "type": "string"
            },
            "source_field": {
              "description": "Exact NOAA SWPC source field",
              "type": "string"
            },
            "unit": {
              "description": "Physical or dimensionless unit",
              "type": "string"
            },
            "value": {
              "description": "Normalized numeric observation",
              "type": "number"
            }
          },
          "required": [
            "value",
            "unit",
            "observed_at",
            "source_field"
          ],
          "type": "object"
        },
        "proton_speed": {
          "additionalProperties": false,
          "description": "Solar-wind proton speed",
          "properties": {
            "observed_at": {
              "description": "Official source observation time",
              "format": "date-time",
              "type": "string"
            },
            "source_field": {
              "description": "Exact NOAA SWPC source field",
              "type": "string"
            },
            "unit": {
              "description": "Physical or dimensionless unit",
              "type": "string"
            },
            "value": {
              "description": "Normalized numeric observation",
              "type": "number"
            }
          },
          "required": [
            "value",
            "unit",
            "observed_at",
            "source_field"
          ],
          "type": "object"
        },
        "proton_temperature": {
          "additionalProperties": false,
          "description": "Solar-wind proton temperature",
          "properties": {
            "observed_at": {
              "description": "Official source observation time",
              "format": "date-time",
              "type": "string"
            },
            "source_field": {
              "description": "Exact NOAA SWPC source field",
              "type": "string"
            },
            "unit": {
              "description": "Physical or dimensionless unit",
              "type": "string"
            },
            "value": {
              "description": "Normalized numeric observation",
              "type": "number"
            }
          },
          "required": [
            "value",
            "unit",
            "observed_at",
            "source_field"
          ],
          "type": "object"
        },
        "source": {
          "description": "SWPC spacecraft/data source",
          "type": "string"
        }
      },
      "required": [
        "proton_density",
        "proton_speed",
        "proton_temperature",
        "source",
        "overall_quality"
      ],
      "type": [
        "object",
        "null"
      ]
    },
    "query": {
      "additionalProperties": false,
      "description": "Normalized empty query identity",
      "properties": {},
      "type": "object"
    },
    "schema_version": {
      "const": "noaa-swpc-normalized-v1",
      "description": "Pinned NOAA SWPC normalization contract",
      "type": "string"
    },
    "source": {
      "additionalProperties": false,
      "description": "Official NOAA SWPC provenance for the served normalized snapshot",
      "properties": {
        "name": {
          "description": "Official source organization",
          "type": "string"
        },
        "products": {
          "description": "Fixed normalized NOAA SWPC products",
          "items": {
            "description": "Product identifier",
            "type": "string"
          },
          "type": "array"
        },
        "retrieved_at": {
          "description": "Time the served normalized snapshot was retrieved",
          "format": "date-time",
          "type": "string"
        }
      },
      "required": [
        "name",
        "products",
        "retrieved_at"
      ],
      "type": "object"
    },
    "source_age_seconds": {
      "description": "Age in whole seconds of the route's controlling freshness timestamp; retrieval time controls alerts and forecast",
      "minimum": 0,
      "type": "integer"
    },
    "stale": {
      "description": "True only when a validated cached snapshot was used",
      "type": "boolean"
    },
    "warnings": {
      "description": "Freshness, missing-component, provenance, and interpretation limitations",
      "items": {
        "description": "Actionable warning",
        "type": "string"
      },
      "type": "array"
    },
    "xray": {
      "additionalProperties": false,
      "description": "Fresh GOES X-ray observation, or null with a warning",
      "properties": {
        "energy": {
          "const": "0.1-0.8nm",
          "description": "Selected GOES energy band",
          "type": "string"
        },
        "flux": {
          "additionalProperties": false,
          "description": "GOES 0.1–0.8 nm X-ray flux",
          "properties": {
            "observed_at": {
              "description": "Official source observation time",
              "format": "date-time",
              "type": "string"
            },
            "source_field": {
              "description": "Exact NOAA SWPC source field",
              "type": "string"
            },
            "unit": {
              "description": "Physical or dimensionless unit",
              "type": "string"
            },
            "value": {
              "description": "Normalized numeric observation",
              "type": "number"
            }
          },
          "required": [
            "value",
            "unit",
            "observed_at",
            "source_field"
          ],
          "type": "object"
        },
        "satellite": {
          "description": "GOES satellite number",
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "flux",
        "energy",
        "satellite"
      ],
      "type": [
        "object",
        "null"
      ]
    }
  },
  "required": [
    "operation",
    "schema_version",
    "query",
    "kp",
    "plasma",
    "magnetic",
    "xray",
    "source",
    "stale",
    "source_age_seconds",
    "warnings"
  ],
  "type": "object"
}