For Agents
Read marine weather observations, sailing forecasts, and coastal webcam data for yacht clubs and regatta events.
Use for: Get the latest wind reading from a SOCIB coastal station, Retrieve the next 48 hours of marine forecast for 39.55, 2.63, List all stations broadcasting for a regatta event ID, Find webcams along the Balearic coast
Not supported: Does not handle global open-ocean forecasting, route planning, or vessel tracking — use for OceanDrivers' Mediterranean station observations, sailing forecasts, and regatta data only.
ODWeather is OceanDrivers' marine weather and observations API, focused on sailing, regattas, and coastal yacht clubs. The endpoints cover land and sea weather stations (AEMET, SOCIB, EasyWind, WeatherDisplay), forecast time-series including WRF model output for any latitude and longitude, regatta event station feeds, and a directory of marine webcams. Coverage skews to Spain and the western Mediterranean where OceanDrivers operates.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the ODWeather 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.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# 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 ODWeather API.
Retrieve current observations from AEMET, SOCIB, EasyWind, and WeatherDisplay coastal stations
Fetch a forecast time series for any latitude and longitude including WRF model output
List event stations associated with a regatta or sailing event by event ID
Compare observations across stations within a regatta location
Retrieve forecast points configured for a specific yacht club in multiple languages
List marine webcams operated within the OceanDrivers network
Patterns agents use ODWeather API for, with concrete tasks.
★ Regatta Race Committee Dashboard
Power a regatta race committee dashboard by pulling current observations from every station registered to a specific event. The /getEventStations/{eventId} call returns the live station list, which the dashboard polls for wind, gust, and direction so race officers can decide on starts and postponements. Useful for sailing federations and clubs running multi-day events on the Spanish coast.
Call /v1.0/getEventStations/{eventId}/ for an event ID and return current wind speed and direction for each station.
Yacht Club Forecast Page
Display tailored marine forecasts for a yacht club by combining /getForecastPoints/{yatchclubid}/language/{language} with /getForecastTimeSeries to render hour-by-hour wind and weather for the club's preferred coastal points. The language parameter supports localised member-facing pages. Forecasts include WRF model output via the Wrf variant for higher-resolution sailing predictions.
Call /v1.0/getForecastTimeSeries/39.55/2.63/ and return the next 24 hours of forecast wind speed and direction.
Coastal Webcam Directory
Render a directory of OceanDrivers' marine webcams alongside live observations so visitors can see and read conditions before heading out. The /getWebCams endpoint returns the catalogue of available cameras with their metadata, and station observation endpoints provide the matching numerical readings. Common in coastal tourism and sailing-school websites.
Call /v1.0/getWebCams/ and return the list of webcams with their location and stream URL.
AI Agent Sailing Briefing
An AI assistant for a sailing crew can deliver a pre-departure briefing by chaining ODWeather operations through Jentic — pulling observations from the nearest station, the local forecast time-series, and the event station list if the trip is a regatta. The agent discovers each operation by intent and synthesises a natural-language briefing without the user reading any raw weather feeds.
Use Jentic to call /v1.0/getForecastTimeSeries/39.55/2.63/ and write a two-sentence wind summary for the next six hours.
10 endpoints — odweather is oceandrivers' marine weather and observations api, focused on sailing, regattas, and coastal yacht clubs.
METHOD
PATH
DESCRIPTION
/v1.0/getForecastTimeSeries/{latitude}/{longitude}/
Forecast time series for a coordinate
/v1.0/getForecastTimeSeriesWrf/{latitude}/{longitude}/
WRF model forecast for a coordinate
/v1.0/getEventStations/{eventId}/
Stations associated with a regatta event
/v1.0/getSocibWeatherStation/{stationName}/{period}/
SOCIB station observations
/v1.0/getAemetStation/{stationName}/{period}/
AEMET station observations
/v1.0/getWebCams/
List marine webcams
/v1.0/getForecastTimeSeries/{latitude}/{longitude}/
Forecast time series for a coordinate
/v1.0/getForecastTimeSeriesWrf/{latitude}/{longitude}/
WRF model forecast for a coordinate
/v1.0/getEventStations/{eventId}/
Stations associated with a regatta event
/v1.0/getSocibWeatherStation/{stationName}/{period}/
SOCIB station observations
/v1.0/getAemetStation/{stationName}/{period}/
AEMET station observations
/v1.0/getWebCams/
List marine webcams
Three things that make agents converge on Jentic-routed access.
Credential isolation
ODWeather endpoints are unauthenticated, so there are no API keys to manage. Jentic still applies its own request-policy controls so agents do not hammer OceanDrivers' public service.
Intent-based discovery
Agents search by intent (e.g. 'sailing forecast for a coordinate') and Jentic returns the matching ODWeather operation with its input schema, so the agent calls the right endpoint without reading the apis.guru spec.
Time to first call
Direct ODWeather integration: half a day for path-parameter mapping and response parsing. Through Jentic: under 30 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using ODWeather API through Jentic.
What authentication does the ODWeather API use?
The endpoints in this spec are open and do not require an API key. Through Jentic the call is routed without credentials, but Jentic still applies its own request-policy controls so agents respect OceanDrivers' service capacity.
Can I get a sailing forecast for any coordinate with this API?
Yes. Use /v1.0/getForecastTimeSeries/{latitude}/{longitude}/ for the standard forecast or /v1.0/getForecastTimeSeriesWrf/{latitude}/{longitude}/ for the higher-resolution WRF model output. Coverage is strongest around Spain and the western Mediterranean where OceanDrivers operates.
What are the rate limits for the ODWeather API?
OceanDrivers does not publish a hard limit in the spec. Treat the service as a cooperative resource — cache forecast time series for at least 30 minutes and avoid polling station observations more than once a minute.
How do I read a regatta event's stations through Jentic?
Search Jentic for 'list stations for a regatta event', load the schema for /v1.0/getEventStations/{eventId}/, then execute with the event ID. With pip install jentic the call is await client.search(...), await client.load(...), await client.execute(...) inside an asyncio.run wrapper.
Is the ODWeather API free to use?
Yes — no key or paid tier is required for the endpoints listed in this spec. Use it cooperatively and credit OceanDrivers in any user-facing display of the data.
Does ODWeather cover global marine forecasts?
Coverage is strongest in Spain and the western Mediterranean where OceanDrivers' station network and WRF model runs are configured. For global open-ocean forecasting use a complementary source such as Stormglass.
GET STARTED