For Agents
Retrieve hourly historical and forecast weather data from ERA5, GFS, ICON, and other models for any global coordinate via a single API call.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Oikolab Weather Data API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Oikolab Weather Data API API.
Pull ERA5 hourly historical weather for any latitude, longitude, and parameter back to 1950
Retrieve GFS, ICON, or HRRR forecasts at hourly resolution for the next 7-15 days
Request multiple parameters (temperature, wind, irradiance, precipitation) in one call
Return data as JSON, CSV, or NetCDF for direct use in pandas or xarray
GET STARTED
Use for: I need ERA5 hourly temperature for a city for the past 5 years, Get the GFS forecast for wind speed at a wind farm for the next 7 days, Retrieve hourly solar irradiance for a solar plant location, Find historical precipitation totals for a specific coordinate
Not supported: Does not provide weather alerts, station-observation data, or air-quality forecasts — use for hourly NWP and reanalysis weather data retrieval only.
Oikolab Weather Data API delivers 70+ years of global hourly historical and forecast weather data drawn from NOAA and ECMWF reanalysis and forecast models. Supported datasets include ERA5, ERA5-Land, GFS, GEFS, ICON, GDPS, IFS-OPEN, CFS, SILAM, HRRR, NAM-CONUS, NBM, HRDPS, ICON-EU, and ICON-D2. A single /weather endpoint returns JSON, CSV, or NetCDF for any latitude, longitude, time range, and parameter set, making it suitable for energy modelling, climate research, and operational forecasting.
Aggregate hourly data into daily means or sums via the resampling parameter
Query high-resolution regional models like HRRR for North America or ICON-D2 for Europe
Patterns agents use Oikolab Weather Data API API for, with concrete tasks.
★ Energy demand modelling
Utilities and energy traders pull hourly ERA5 historical temperature and forecast GFS or ECMWF data for major load centres to feed demand and price models. The single-endpoint design lets analysts request every parameter and timestamp they need in one call, returning a tidy CSV or NetCDF that drops straight into a regression or ML pipeline.
Request ERA5 hourly temperature, wind speed, and solar irradiance for a coordinate over the past 10 years and return a CSV
Renewables generation forecasting
Wind and solar operators use Oikolab to backtest and operationally forecast generation by pulling reanalysis irradiance and wind data alongside near-term forecasts from HRRR, ICON, or GFS. Switching between models is a single parameter change, which lets quants compare model skill without rebuilding ingestion pipelines.
Pull GFS forecast wind speed at 100 m for the next 72 hours at three turbine coordinates and return a JSON time series per location
Climate risk analytics
Insurance and infrastructure firms run climate-risk analyses using 70+ years of ERA5 reanalysis to compute return periods for heat, cold, and precipitation events. The CSV and NetCDF output formats stream directly into xarray for spatial-temporal aggregation, removing the friction of standing up Copernicus CDS access.
Retrieve ERA5 daily maximum temperature at a coordinate for 1980-2024 and compute the 99th percentile per decade
AI agent weather lookup via Jentic
An AI agent answering 'what was the weather in Madrid last Tuesday?' uses Jentic to call the Oikolab API without managing the api-key header. The agent searches for a weather lookup intent, loads the /weather schema, and executes with the coordinate, parameter, and date — Jentic injects the api-key from the vault.
Search Jentic for a historical-weather lookup, load the /weather schema, and execute it for Madrid on a user-supplied date with hourly temperature
1 endpoints — oikolab weather data api delivers 70+ years of global hourly historical and forecast weather data drawn from noaa and ecmwf reanalysis and forecast models.
METHOD
PATH
DESCRIPTION
/weather
Return hourly historical or forecast weather for a coordinate, model, and parameter list
/weather
Return hourly historical or forecast weather for a coordinate, model, and parameter list
Three things that make agents converge on Jentic-routed access.
Credential isolation
Oikolab api-key header values are stored encrypted in the Jentic vault and injected at request time. The agent receives a scoped execution token; the raw API key never enters the agent's context.
Intent-based discovery
The API has one endpoint, so the value is in parameter discovery — model names, parameter codes, and date formats. Jentic's intent search returns the operation with the right model and parameter values prefilled for the requested intent.
Time to first call
Direct integration including model selection, parameter code lookup, and rate-limit handling: half a day. Through Jentic: under 30 minutes.
Alternatives and complements available in the Jentic catalogue.
OpenWeatherMap API
Consumer-grade weather API with current conditions, 5-day forecasts, and historical data
Choose OpenWeatherMap for app-style current weather and short forecasts. Choose Oikolab when the requirement is hourly resolution, multi-decade history, or specific NWP models like ERA5 or HRRR.
WeatherAPI.com
Forecast and historical weather API with simpler parameter set than NWP-model-level access
Use WeatherAPI for simple daily and hourly forecasts in app contexts. Use Oikolab when the workflow needs raw model output (ERA5, GFS, HRRR) for analytics.
Visual Crossing Weather API
Aggregated weather records useful for cross-validation against Oikolab reanalysis pulls
Use Visual Crossing when station-observation data is preferred; Oikolab returns gridded model output and may differ at point locations.
AccuWeather Core API
Commercial forecast API with location-keyed forecasts as an alternative when NWP model output is not required
Choose AccuWeather for branded consumer forecast experiences. Choose Oikolab for analytical workloads on raw NWP output.
Specific to using Oikolab Weather Data API API through Jentic.
What authentication does the Oikolab Weather Data API use?
The API uses an API key passed in the api-key header. Through Jentic, the key is stored encrypted in the vault and injected at request time, so the raw header value never enters the agent's context.
Can I retrieve ERA5 historical weather with the Oikolab API?
Yes. Pass model=era5 (or era5-land for higher-resolution land data) along with the desired parameters, latitude, longitude, and a start and end date. The endpoint returns hourly values back to 1950 in JSON, CSV, or NetCDF.
What are the rate limits for the Oikolab Weather Data API?
Oikolab applies per-account quotas based on the subscription tier. Free trial keys have lower daily call and data-volume caps; paid tiers raise these. The response headers expose remaining quota — check them in production agents and back off when nearing the limit.
How do I pull a forecast for a specific location through Jentic?
Search Jentic for 'oikolab forecast', load the schema for /weather, and execute with model set to gfs, ecmwf, or a regional model, plus latitude, longitude, parameter list, and a future time range. The result includes hourly forecast values up to the model's horizon.
Which output formats does the Oikolab API support?
JSON, CSV, and NetCDF are all supported through a format query parameter. JSON is most convenient for ad-hoc queries; CSV is convenient for pandas; NetCDF is preferred for scientific workloads and integrates with xarray for multi-dimensional analysis.
Is the Oikolab Weather Data API free?
A free trial key is available with limited daily quota. Paid tiers provide higher quotas, more datasets, and commercial-use rights. Pricing is based on data volume retrieved rather than per-call, so request only the parameters and time range you need.