# One Call 3.0 weather data

> OpenWeather's One Call 3.0 for autonomous agents — the full forecast document in one call, plus historical timemachine, day summaries and a plain-language overview. 1 credit per successful call.

## The good on this shelf

**One Call 3.0 weather data, by OpenWeather** — the same supplier's other One Call
generation, on the shelf beside the first feed. Where One Call serves grained timelines
route by route, One Call 3.0 answers with **one full document per call** — current
conditions, minute, hourly and daily forecasts and government weather alerts together — and
adds three views of its own:

| Route | What it answers |
|---|---|
| `forecast` | the whole answer in one document: current + minutely + hourly + daily + alerts (supports the supplier's `exclude` parameter) |
| `timemachine` | the weather at this coordinate at a past moment (`dt`, unix time) |
| `day_summary` | one day aggregated (`date`, YYYY-MM-DD) |
| `overview` | a plain-language weather overview for the coordinate |

Addressed by latitude and longitude like its sibling; the exact request contract, response
envelope and a sample live in the [machine-readable data spec](/specs/onecall3.v0.json) —
what an agent reads before spending. The supplier's own reference is
[openweathermap.org/api/one-call-3](https://openweathermap.org/api/one-call-3).

## The price, in dollars

- **One successful call costs one credit. One credit is $0.001.**
- A new account is granted **1,000 credits at signup**, spendable on any feed — One Call 3.0
  included. The smallest top-up is **$10, which buys 10,000 calls**.
- Credits are prepaid; nothing is ever served on credit, and a runaway agent produces a
  wall, never an invoice.
- Failed calls and upstream errors are recorded but **never billed**.

The [live catalogue](https://api.forum.bot/v1/products) is the authority: the price it
quotes is the price charged, with no markup between the quote and the bill.

## Licence

ODbL-1.0, attribution required — the same licence family as its sibling feed. The
attribution text arrives **inside every response** (`meta.licence`), so an agent obliged to
attribute the data has everything it needs in the answer that carried it.

## Delivery

Proxied through the Forum gateway. Access is a Bearer key an agent obtains by API in
one call; every response reports its own cost and the remaining balance, and a revoked key
stops working within seconds.

## When the supplier directly is the better choice

If one agent can stay inside OpenWeather's own One Call 3.0 allowance, go direct — it is
cheaper. This feed earns its keep when multiple agents need separate credentials, spending
boundaries, one bill and revocation that works in seconds.

## Machine resources

- [Live product catalogue](https://api.forum.bot/v1/products)
- [Product data spec](/specs/onecall3.v0.json)
- [Agent quickstart](/llms.txt)