Wavebase Global Ocean Conditions

Wavebase Global Ocean Conditions APIs provide 10-day forecasts, at 3-hourly intervals, updated daily for waves, tide and wind at any point on the ocean surface.
(Search by a single point or use bulk-search to search against multiple points in a single-transaction.)

Wavebase Global Ocean Tiles API provides XYZ map-tiles for Wave Significant Height, Primary Swell Wave Height and Wave Peak Period at 10-day forecasts and 3-hourly intervals. (Currently zoom levels 0 to 4 - contact us if higher zoom levls are required.)

Powered by Atlantis Technologies

Ocean Condition Forecast Closest to Latitude / Longitude

​https://api.wavebase.app/v4/conditions/search/{latitude}/{longitude}

Search for current and predicted ocean conditions closest to a given latitude/longitude.

Returned conditions include the closest point found, along with Waves, Tides and Weather conditions are the location.

Example: Conditions in Middle of Atlantic

Request: GET - https://api.wavebase.app/v4/conditions/search/47.623385/-23.185028

Response (Content-Type:application/json (concatenated)):

{
  "closest_coordinates": {
    "latitude": 47.666668,
    "longitude": -23.166666
  },
  "conditions": [
    {
      "primary_swell_wave_from_direction": 10.540008544921875,
      "tide_direction": "rising",
      "tide_height": 20.6,
      "tide_state": "mid",
      "valid_for_dtg": "2024-05-02T09:00:00Z",
      "wave_mean_period_from_variance_spectral_density_second_freq": 7.579999923706055,
      "wave_period_at_variance_spectral_density_maximum": 11.109999656677246,
      "wave_significant_height": 3.1999998092651367,
      "wind_dir": 338.5,
      "wind_speed": 7.7
    },
    {
      "primary_swell_wave_from_direction": 11.830001831054688,
      "tide_direction": "rising",
      "tide_height": 20.6,
      "tide_state": "mid",
      "valid_for_dtg": "2024-05-02T12:00:00Z",
      "wave_mean_period_from_variance_spectral_density_second_freq": 7.849999904632568,
      "wave_period_at_variance_spectral_density_maximum": 11.369999885559082,
      "wave_significant_height": 3.319999933242798,
      "wind_dir": 347.7,
      "wind_speed": 7.5
    }, 
    {...}
  ]
}

Bulk Ocean Conditions for a Set of Points

​https://api.wavebase.app/v4/conditions/search/bulk

Search for current wave conditions closest to a set of latitude/longitude points.

Returned conditions include only wave conditions at the locations (i.e. no tide nor weather).

Example: Current Conditions for 10 locations around the world

Request: POST - https://api.wavebase.app/v4/conditions/search/bulk

Request Body:

{
	"coordinates":[
		{"latitude":43.5147125,"longitude":-70.3751205},
        {"latitude":41.189674,"longitude":30.255351},
        {"latitude":40.615757,"longitude":26.468853},
        {"latitude":39.81308,"longitude":26.0071315},
        {"latitude":33.986219000000006,"longitude":-118.4756075},
        {"latitude":36.25278,"longitude":29.31259},
        {"latitude":37.031845,"longitude":27.400035},
        {"latitude":37.032147,"longitude":27.4018715},
        {"latitude":37.030792,"longitude":27.380052},
        {"latitude":37.118895,"longitude":27.273711}
    ],
    "columns":[
        "primary_swell_wave_from_direction",
        "wave_significant_height", 
        "wave_period_at_variance_spectral_density_maximum"
    ]
}

Response (Content-Type: appliation/json):

NOTE: Conditions are provided in the original coordinate ordering of the request.

{
  "waves": [
    {
      "primary_swell_wave_from_direction": 110.86000061035156,
      "valid_for_dtg": "2024-05-02T09:00:00Z",
      "wave_period_at_variance_spectral_density_maximum": 11.630000114440918,
      "wave_significant_height": 0.44999998807907104
    },
    {
      "primary_swell_wave_from_direction": 40.33000183105469,
      "valid_for_dtg": "2024-05-02T09:00:00Z",
      "wave_period_at_variance_spectral_density_maximum": 6.920000076293945,
      "wave_significant_height": 0.8799999952316284
    },
    {
      "primary_swell_wave_from_direction": 77.68000030517578,
      "valid_for_dtg": "2024-05-02T09:00:00Z",
      "wave_period_at_variance_spectral_density_maximum": 3.379999876022339,
      "wave_significant_height": 0.04999999701976776
    },
    {
      "primary_swell_wave_from_direction": 61.88999938964844,
      "valid_for_dtg": "2024-05-02T09:00:00Z",
      "wave_period_at_variance_spectral_density_maximum": 2.7899999618530273,
      "wave_significant_height": 0.28999999165534973
    },
    {
      "primary_swell_wave_from_direction": 267.1199951171875,
      "valid_for_dtg": "2024-05-02T09:00:00Z",
      "wave_period_at_variance_spectral_density_maximum": 7.199999809265137,
      "wave_significant_height": 1.0299999713897705
    },
    {
      "primary_swell_wave_from_direction": 237.8800048828125,
      "valid_for_dtg": "2024-05-02T09:00:00Z",
      "wave_period_at_variance_spectral_density_maximum": 5.069999694824219,
      "wave_significant_height": 1.0499999523162842
    },
    {
      "primary_swell_wave_from_direction": 293.92999267578125,
      "valid_for_dtg": "2024-05-02T09:00:00Z",
      "wave_period_at_variance_spectral_density_maximum": 4.029999732971191,
      "wave_significant_height": 0.5099999904632568
    },
    {
      "primary_swell_wave_from_direction": 293.92999267578125,
      "valid_for_dtg": "2024-05-02T09:00:00Z",
      "wave_period_at_variance_spectral_density_maximum": 4.029999732971191,
      "wave_significant_height": 0.5099999904632568
    },
    {
      "primary_swell_wave_from_direction": 293.92999267578125,
      "valid_for_dtg": "2024-05-02T09:00:00Z",
      "wave_period_at_variance_spectral_density_maximum": 4.029999732971191,
      "wave_significant_height": 0.5099999904632568
    },
    {
      "primary_swell_wave_from_direction": 291.2900085449219,
      "valid_for_dtg": "2024-05-02T09:00:00Z",
      "wave_period_at_variance_spectral_density_maximum": 4.539999961853027,
      "wave_significant_height": 0.5899999737739563
    }
  ]
}

Wavebase Global Ocean Tiles API:

XYZ Tile Server providing global tiles for 3 variables (see below) at a specified 3-hourly time point.

Zoom levels 0-4 are available.

Tiles are available at 3-hourly time-slots up to 10 days in the future.

Wave Signficant Height (GET): https://tiles.wavebase.app/{variable}/{date-time slot - YYYYMMDDHH}/{Z}/{X}/{Y}.png

Variable options:

• VHM0 - Wave Significant Height
• VHM0_SW1 - Primary Swell Wave Height
• VTPK - Wave Peak Period

Example: Global Tile at 0/0/0 for Wave Height

Request: GET - https://tiles.wavebase.app/VHM0/2024050103/0/0/0.png

Response: (Content-Type: image/png)