---
title: "Signed NOAA weather observation for a US coordinate"
method: GET
path: "/v1/oracle/weather"
---

# Signed NOAA weather observation for a US coordinate

`GET /v1/oracle/weather`

## Request

- Base URL: `https://soren.com`
- URL: `https://soren.com/v1/oracle/weather`
- Auth: none declared

Latest US National Weather Service station observation, returned with a SHA-256 of the exact upstream bytes, the moment Soren read them, and an Ed25519 signature over both. Public-domain data; the attestation is what is sold. Soren signs, it does not originate. Verify with https://soren.com/oracle-key.json

## Query parameters

- `lat` number, required
- `lon` number, required

## Response `200`

Signed observation.

- object
  - `value` object
  - `source` object
    - `name` string
    - `url` string
    - `licence` string
    - `notice` string
  - `provenance` object
    - `resource` string
    - `upstream_sha256` string
    - `observed_at` string, date-time
    - `signature` object
      - `algorithm` string
      - `over` string
      - `value` string
      - `public_key` string
    - `verify` string
  - `attestation` string
  - `settlement` string, nullable

## Other responses

- `400`: Missing or invalid coordinates. Refused before payment.
- `402`: Payment required. Requirements in the PAYMENT-REQUIRED header (x402 v2) and the body (v1).
- `404`: No observation station covers that point.
- `503`: The upstream source did not answer.

---

[API](https://skmtc.dev/soren/apis/soren-free-games-api.md) · [All operations](https://skmtc.dev/soren/apis/soren-free-games-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soren/apis/soren-free-games-api/revisions/00402cfcf30d?raw)