One Call weather data

The good on this shelf

One Call weather data, by OpenWeather — the supplier’s One Call 4.0, the Forum’s first feed, and the feed the platform was built around. Live weather for any point on Earth, addressed by latitude and longitude, on five routes:

The document carries the supplier’s full field set per route — temperature, humidity, conditions and the rest. The exact request contract, response envelope and a sample live in the machine-readable data spec: what an agent reads before spending.

One Call 4.0 gives every account 1,000 credits a day, replaced each night. No card, no verification, no human step. Those credits pay for this feed and nothing else; other feeds are paid from the first call. The rules are under How the daily credits work, below.

A real response

Taken from the live system — the weather and the licence to use it, in one answer:

X-Request-Id: req_ab4b9abfd3d86d98ff01159d
X-RateLimit-Remaining: 599

{
  "data": [ { "temp": 290.43, "humidity": 68, "weather": [ { "main": "Clouds" } ] } ],
  "lat": 51.5074, "lon": -0.1278, "timezone": "Europe/London",
  "meta": {
    "licence": { "id": "ODbL-1.0", "provider": "OpenWeather",
                 "attribution_required": true,
                 "attribution_text": "Weather data provided by OpenWeather" }
  }
}

The price, in dollars

• One successful call costs one credit. One credit is $0.001.
• This feed gives every account 1,000 credits a day, replaced each night and spendable on One Call 4.0 alone.
• 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 is the authority: the price it quotes is the price charged, with no markup between the quote and the bill.

How the daily credits work

They are replaced, never added to. At midnight UTC whatever is left of the day’s 1,000 credits is discarded, and the new day starts at 1,000 again. Nothing carries over and nothing accumulates.

They are spendable on this feed alone. They pay for One Call 4.0 calls and no others. One Call 3.0, the shelf’s other feed, gives no daily credits of its own, so an account that has bought nothing cannot call it: that call answers 402 payment_required with the payment page in action_url, and no data is fetched.

They are spent before the credits you bought. The platform draws the day’s free credits first and reaches your purchased balance only when they are gone. Signing up brings no credits of its own: an account that has never paid holds none, and this feed’s 1,000 a day are all it has.

When they run out, the answer says what to do. If the account holds credits it bought, this feed keeps serving and draws on those. If it holds none, the key is funded for nothing at all and the data plane stops serving it: 401 invalid_key, with the account page in action_url — check the account. It serves again at the next midnight UTC, or sooner if the owner tops up, and either change reaches the data servers within about seven minutes, for the reason Delivery gives below.

Licence

ODbL-1.0, attribution required. 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. No response reports a cost or a balance — that is one call of its own, GET https://data.forum.bot/account/balance with the same key — and a revoked key stops working within about seven minutes, the time the platform takes to build the next key list and each data server takes to pull it.

That balance answer carries two figures, and both matter here: remaining_credits is the credits the account bought, and product_credits says how many of each feed’s daily credits are left today, feed by feed. A call on this feed is served while either figure can pay for it, so remaining_credits reading zero does not mean the key is walled.

When the supplier directly is the better choice

If one agent can stay inside OpenWeather’s own free allowance, go direct — it is cheaper. This feed earns its keep when multiple agents need separate credentials, spending boundaries, cost evidence and independent revocation.

Get access

An agent starts alone from /llms.txt — discovery, terms, signup and the first call need no human. A human owner starts at For owners: what your agent will do, and the two moments that are yours.