# NOAA Tides and Currents API

> US tide predictions, live water levels, currents and weather at NOAA coastal stations

- Vendor: `noaatidesandcurrentsapi` · version 1.0 · category Weather · tags noaa tides api, tide predictions api, water level api, ocean currents api, coastal weather api, high low tide api, marine data api, tide station api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/noaatidesandcurrentsapi
- This document: https://apiclay.com/docs/noaatidesandcurrentsapi.md
- OpenAPI 3.1: https://apiclay.com/api/noaatidesandcurrentsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `noaatidesandcurrentsapi`
- Updated: 2026-11-18

## About

## NOAA Tides and Currents API

Tide predictions (high/low or every 6 minutes), observed water levels, currents, and air/water temperature and wind at 3,000+ NOAA coastal stations in the US and its territories.

Data comes from **tidesandcurrents.noaa.gov** (https://tidesandcurrents.noaa.gov). Every route below calls the source's own public endpoint directly and returns the upstream response unchanged.

### Routes

#### GET `/data` - Station data
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| station | query | string | yes | Station id, e.g. `9414290` (San Francisco). |
| product | query | string | yes | `predictions`, `water_level`, `currents`, `air_temperature`, `water_temperature`, `wind`, `hourly_height`, `high_low`... |
| date | query | string | no | `today`, `latest` or `recent`. |
| begin_date | query | string | no | yyyyMMdd (with `end_date` or `range`). |
| end_date | query | string | no | yyyyMMdd. |
| range | query | number | no | Hours of data. |
| datum | query | string | no | Required for water levels, e.g. `MLLW`. |
| units | query | string | no | `english` or `metric`. |
| time_zone | query | string | no | `gmt`, `lst` or `lst_ldt`. |
| interval | query | string | no | Predictions: `hilo`, `h` or `6`. |

Returns: `predictions[]` (`t`, `v`, `type` H/L) or `data[]` (`t`, `v`, flags) plus `metadata`.

#### GET `/station` - Station details
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| station_id | path | string | yes | e.g. `9414290`. |

Returns: `stations[0]` with `name`, `state`, `lat`, `lng`, `timezone`, `tidal`, `products`.

### Not yet available

| Endpoint | Why |
|---|---|
| Full station list | 2 MB response, 12 s |

### License

NOAA data is US government work and in the public domain.

### Caveats

- Find station ids on tidesandcurrents.noaa.gov (map) until the station list route is added.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by tidesandcurrents.noaa.gov.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /data — Station data (tides, water level, met)
- Gateway: `GET https://api.apiclay.com/v1/api/noaatidesandcurrentsapi/data`
- Public query params: `station` (string, required), `product` (string, required), `date` (string), `begin_date` (string), `end_date` (string), `range` (string), `datum` (string), `units` (string), `time_zone` (string), `interval` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /station — Station details
- Gateway: `GET https://api.apiclay.com/v1/api/noaatidesandcurrentsapi/station`
- Public query params: `station_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/noaatidesandcurrentsapi/data?station=<station>&product=<product>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
