Developer docs

Authentication

API keys are issued after a partner enquiry. All requests use HTTPS and carry the key in the Authorization header.

• Per-key rate limit: 60 per minute, 10,000 per day (default, raised by contract)
• Key rotation: the old key stays valid for 7 days after a new one is issued
• Attribution: under Korea's Weather Industry Promotion Act, displayed results must credit 'Source: Wellbian AI · KWeather'

GET /v1/forecast/point?lat=37.5665&lon=126.9780&horizon=60d
Authorization: Bearer <API_KEY>
Accept: application/json

Inference API

Returns forecasts, indexes, and risk indexes at point, neighbourhood, or 1.5 km grid level. Refresh cadence follows the product.

• /v1/forecast/point - 60-day (6 h), 15-day (6 h), 3-day (1 h), and nowcast (10 min) forecasts, selected with horizon
• /v1/index/{life|heat|heating|sales|construction} - life, heat, heating, sales-impact, and work-weather indexes
• /v1/risk/{heat|rain|wind|snow} - stage (1 to 4), start and end times, supporting variables
• /v1/nowcast/precip - radar precipitation, 2 h at 10 min and 12 h at 1 h, 1 km
• Response: JSON, timestamps in ISO 8601 (KST), SI units (°C, mm, m/s)

{
  "point": { "lat": 37.5665, "lon": 126.9780, "grid": "1.5km" },
  "issued_at": "2026-09-30T06:00:00+09:00",
  "horizon": "60d",
  "series": [ { "t": "2026-09-30T12:00:00+09:00", "temp": 24.1, "rain_mm": 0.0, "wind_ms": 2.3, "pop": 10 } ],
  "source": ["kweather", "nvidia-earth2/fcn3", "wellbian-sensors"]
}

Agent integration

The 60-day forecast agent can be linked directly with a deep link. Widget and webhooks are in preparation.

• Deep link: /agent?q=<question>&lat=<lat>&lon=<lon>&domain=<golf|hiking|fishing|travel|fashion|air>
• Verdict structure: headline, condition chips, timeline, metric cards, alert banner (same as the app)
• Alert webhook: POST <your_url> when conditions change (in preparation)
• Chat widget: one-line script embed (in preparation)

https://wellbianai.io/agent?q=hiking%20Bukhansan%20this%20weekend&lat=37.66&lon=126.98&domain=hiking

Access pass NFT

The AI Factory access pass is a utility NFT issued on the XRP Ledger, for content payment only. It carries no investment or return promise.

• Issuance: 4,000 passes, valid 3 years, taxon 4026
• Benefit: wallets holding a pass pay for inference API and agent content with the pass
• Verification: XRPL wallet signature confirms ownership, then the wallet is linked to an API key
• Purchase: wellbian.io/products/ai-factory-pass

Data sources and quality

Every result carries a source array. Observations are redistributed Korea Meteorological Administration data; fine-dust observations come from the Wellbian and KWeather sensor networks.

• kweather - KWeather forecasters and numerical models
• nvidia-earth2/{fcn3|atlas|corrdiff|stormscope} - AI factory output
• wellbian-sensors - Wellbian sensor network readings (ARC-600DA and others)
• kma - Korea Meteorological Administration observations and warnings