SC

Swellcloud API

Interactive playground & quick docs

Docs

Playground

Query /v1/point and preview the JSON response.

API Base URL

Usually /api when reverse-proxied; otherwise full origin (e.g. https://swellcloud.net/api).

API Key

Location

Drag the marker or type below.

Lat

Lon

Variables

hs tp dp wndspd wnddir

Units

Interpolation

Start (UTC)

End (UTC)

Response

Request URL

—

JSON

// Run a query to see output here…

Headers

—

Quick docs

Endpoint

GET /v1/point?lat=<float>&lon=<float>&vars=hs,tp,dp&start=YYYY-MM-DDTHH:mmZ&end=YYYY-MM-DDTHH:mmZ&units=si|uk&interp=bilinear|nearest
Header: x-api-key: <your key>

Example

curl -s \
  -H "x-api-key: $API_KEY" \
  "$API_BASE/v1/point?lat=50.087&lon=-5.318&vars=hs,tp,dp&start=2025-10-12T00:00Z&end=2025-10-13T00:00Z&units=uk" | jq .

Notes

Times are UTC ISO-8601.
Only requested variables are returned.
units=uk converts HS to feet and wind to mph; si keeps SI.
Rate limits and remaining quota (if exposed) appear in response headers.