Oceandrivers ODWeather API

Name: ODWeather API
Brand: ODWeather API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMaps GeolocationPlaces Searchnone10 Endpoints

Install Jentic One Beta

Connect the ODWeather API to your agent

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://jentic.com/install.sh?src=apis&api=%2Fapis%2Foceandrivers.com%2Foceandrivers-main" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Foceandrivers.com%2Foceandrivers-main" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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.

Capabilities

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

GET STARTED

Start building with ODWeather API

Explore with Jentic One

View OpenAPI Document

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.

Use Cases

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.

Key Endpoints

10 endpoints — odweather is oceandrivers' marine weather and observations api, focused on sailing, regattas, and coastal yacht clubs.

METHOD

PATH

DESCRIPTION

GET

/v1.0/getForecastTimeSeries/{latitude}/{longitude}/

Forecast time series for a coordinate

GET

/v1.0/getForecastTimeSeriesWrf/{latitude}/{longitude}/

WRF model forecast for a coordinate

GET

/v1.0/getEventStations/{eventId}/

Stations associated with a regatta event

GET

/v1.0/getSocibWeatherStation/{stationName}/{period}/

SOCIB station observations

GET

/v1.0/getAemetStation/{stationName}/{period}/

AEMET station observations

GET

/v1.0/getWebCams/

List marine webcams

GET

/v1.0/getForecastTimeSeries/{latitude}/{longitude}/

Forecast time series for a coordinate

GET

/v1.0/getForecastTimeSeriesWrf/{latitude}/{longitude}/

WRF model forecast for a coordinate

GET

/v1.0/getEventStations/{eventId}/

Stations associated with a regatta event

GET

/v1.0/getSocibWeatherStation/{stationName}/{period}/

SOCIB station observations

GET

/v1.0/getAemetStation/{stationName}/{period}/

AEMET station observations

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the ODWeather API by hand means pointing at api.oceandrivers.com, respecting OceanDrivers' public-service limits, and coding your own retry handling across its forecast and station endpoints. Through Jentic you install once, import the ODWeather API from the API Directory, and your agent calls it, with no key to manage because the endpoints are unauthenticated.

Permission scoping

This API is read-only Mediterranean weather and regatta data, so scope it by operation: limit the agent to the operations it needs, such as forecast time series, event stations, or webcams, and leave the rest out. You choose which operations it may call, so nothing beyond the allowed reads runs.

Credential isolation

The ODWeather endpoints are unauthenticated, so there is no key for your Jentic One instance to store. Jentic still applies its own request-policy controls at execution time so agents do not hammer OceanDrivers' public service.

Intent-based discovery

Agents search Jentic by intent such as '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 source spec.

FAQs

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.

Can I limit what my agent is allowed to do with the ODWeather API?

Yes. Because you run Jentic One yourself, your own rules decide which ODWeather operations and credentials the agent may use. Since the API is read-only, you scope it by operation: allow only what the agent needs, such as forecast time series, regatta event stations, or the webcam list, and leave the rest out. Anything you do not permit will not run, so the agent never touches operations beyond the reads you approved.