Swellcloud Surf Forecasting API

Location and Time

Latitude

Longitude

Start (UTC)

End (UTC)

Performance Warning: Long date queries (e.g., 16 days) can take up to 2 minutes to process. We recommend you cache these results in a production environment.

Map Location

Click map to position marker

Marine Variables

Wave Variables

Significant Wave Height

Significant mean wave height (hs)

Peak Wave Period

Peak period between waves (tp)

Wave Direction

Peak wave direction (dp)

Wind Variables

Wind Speed

Surface wind speed (wndspd)

Wind Direction

Surface wind direction (wnddir)

Model Selection

GFS Wave Model Default

Resolution: 0.25° (~28 km) • Updates: 4x daily • Range: 16 days

Full variable suite including wind and secondary swell

CMEMS Global Wave High-Res

Resolution: 1/12° (~9 km) • Updates: Daily • Range: 10 days

3x higher resolution with satellite data assimilation

⚠️ First request may take 10-30 seconds to download data

Units

API Response

Request URL

Click "Run Query" to see API URL

JSON Response

// Click "Run Query" to see response...

Forecast Charts

Variable

Forecast Hour

API Documentation

Endpoint

GET https://api.swellcloud.net/v1/point

Authentication

All API requests require an API key sent via the X-API-Key header.

🎮 Playground Test Key:

test_playground_key_12345

Limited to playground testing only

🔑 Production API Key:

For regular use, request your API key by emailing api@swellcloud.net

Parameters

Parameter	Type	Default	Description
lat	float	required	Latitude (-90 to 90)
lon	float	required	Longitude (-180 to 180)
vars	string	hs,tp,dp	Comma-separated: hs, tp, dp, wndspd, wnddir
model	string	gfs	Wave model: gfs or cmems-global
units	string	si	si (meters, m/s) or uk (feet, mph)
start	ISO 8601	now	Start time (UTC), e.g. 2025-10-13T00:00Z
end	ISO 8601	now+24h	End time (UTC)

Example cURL

GFS Model (default):

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.swellcloud.net/v1/point?lat=50.087&lon=-5.318&model=gfs" | jq .

CMEMS High-Res Model:

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.swellcloud.net/v1/point?lat=50.087&lon=-5.318&model=cmems-global" | jq .

Variables

hs - Wave height (m or ft)
tp - Peak wave period (s)
dp - Wave direction (°)
wndspd - Wind speed (m/s or mph)
wnddir - Wind direction (°)

Available Models

GFS Wave (default)

0.25° (~28 km) • 16 days • 4x daily updates

CMEMS Global ⚡

1/12° (~9 km) • 10 days • Daily updates • High-Res