Buy API access with nothing but a wallet: quote → on-chain payment → claim. A subscription returns an access token at claim time; per-call metering issues a key after prepayment. Member accounts are optional - they keep your history - and AI agents need none.

Simulator settlement rules (prediction markets, parametric covers) live at weatherfi.io/docs. The former API host weathermarket.ai keeps answering until 2027-09-30 with a Deprecation header; new integrations should use this host.

POST /api/v1/determinations
x-api-key: wdm_key_…            # metered: charged per determination (price in the 402)
# or  Authorization: Bearer wdm_sub_…   # subscription covering the city: included

{ "city": "seoul", "metric": "temp", "op": "gte", "threshold": 35,
  "targetHour": "2026-08-15T14:00:00Z", "label": "heat contract #42" }

→ 201 { "id": "…", "status": "open", "condition": {…}, "next": "Resolves after … on the next hourly run" }

GET /api/v1/determinations/{id}    # same credential
→ { "status": "resolved", "outcome": "met",
    "report": { "reason": "Consensus temperature at the target hour was 35.4°C; the condition was at or above 35°C. 2 independent observation(s) supported the consensus and 0 disagreed; 11 sources contributed and 1 outlier(s) were excluded.",
                "value": 35.4, "verdict": "verified", "agree": 2, "disagree": 0, "nSources": 11, "excluded": 1 } }

// ── A. Subscription or dataset purchase (single or bundle) - no signup, no API key (xrpl.js)
// Dates are computed, not pasted: a hardcoded range goes stale and the request
// starts failing the day it falls outside the allowed window.
const day = (n) => new Date(Date.now() + n * 86400000).toISOString().slice(0, 10);
const from = day(0);            // start today, or any day within the next 90
const to   = day(364);          // up to 365 days from that start

const quote = await (await fetch(
  BASE + `/api/quote?cities=seoul,tokyo,london&from=${from}&to=${to}`
)).json();
// quote.priceUsdt = the USD price; quote.xrpl = how to pay it in XRP:
//   { destination, destinationTag, amount: { drops }, rate: { usdPerXrp, source } }
// The drops are fixed for ten minutes at the FTSOv2 XRP/USD rate - send at least that many.
// Never precompute the price - 30- and 365-day terms are discounted, so days x rate is wrong.

const tx = await client.submitAndWait(wallet.sign(await client.autofill({
  TransactionType: "Payment",
  Account: wallet.address,
  Destination: quote.xrpl.destination,
  DestinationTag: quote.xrpl.destinationTag,   // binds the payment to this quote - required
  Amount: quote.xrpl.amount.drops,
})).tx_blob);

const claim = await (await fetch(BASE + "/api/purchases/claim", {
  method: "POST", headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ txHash: tx.result.hash, quoteId: quote.quoteId, chain: "xrpl" }),
})).json();
// subscription: claim.accessToken (wdm_sub_…) → Authorization: Bearer on /api/v1/sub/live?city=
// dataset:      claim.data.cities[slug].rows: date, tavg, tmax, tmin, precip, rain, humidity, wind, verdict

// ── B. Prepaid per-call metering (HTTP 402) - 0.04 USD per oracle call, paid in XRP
const { payment } = await (await fetch(BASE + "/api/agent/topup")).json();
// payment = { destination, destinationTag: 402, pricePerCallUsd, minTopupUsd, minTopupXrp, rate }
// Buy ~1,000 calls at the current rate - do not hardcode the amount.
const xrp = (1000 * Number(payment.pricePerCallUsd) / payment.rate.usdPerXrp).toFixed(6);
const topup = await client.submitAndWait(wallet.sign(await client.autofill({
  TransactionType: "Payment", Account: wallet.address,
  Destination: payment.destination, DestinationTag: payment.destinationTag,
  Amount: xrpToDrops(xrp),
})).tx_blob);

// Prove the sending account is yours: sign the auth message with the account key.
const ts = String(Date.now());
const msgHex = Buffer.from(`WeatherMarket auth ${wallet.address} ${ts}`, "utf8").toString("hex");
const { apiKey } = await (await fetch(BASE + "/api/agent/topup", {
  method: "POST", headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ txHash: topup.result.hash, address: wallet.address, ts,
    sig: sign(msgHex, wallet.privateKey), pubKey: wallet.publicKey }),   // ripple-keypairs
})).json();

const r = await (await fetch(BASE + "/api/agent/oracle?city=seoul", {
  headers: { "x-api-key": apiKey },
})).json(); // { index, wdi, tdi, rain, verdict, credits: { left } } - 402 when drained