fourzerotwo-si

fourzerotwo-si Tides API

US Tides & Water Levels: NOAA tide stations across US coasts and the Great Lakes: high and low tide predictions, observed water levels and current station weather (water and air temperature, wind, pressure).

Documentation GitHub OpenAPI

Operations 6

GET /v1/tides/stations-near US Tides & Water Levels: Tide stations near a point #

GET /v1/tides/search US Tides & Water Levels: Find tide stations #

GET /v1/tides/station US Tides & Water Levels: Tide station details #

GET /v1/tides/predictions US Tides & Water Levels: High and low tides #

GET /v1/tides/water-level US Tides & Water Levels: Observed water level #

GET /v1/tides/conditions US Tides & Water Levels: Station conditions now #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/fourzerotwo-si/openapi/fourzerotwo-si-tides-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/fourzerotwo-si:fourzerotwo-si-tides-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Fourzerotwo Si Tides API
  version: 1.1.0
  contact:
    url: https://fourzerotwo.si
  description: 'Operations tagged tides across 2 of this provider''s published API definitions: openapi.json, fourzerotwo-si-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://fourzerotwo.si
tags:
- name: tides
  description: 'US Tides & Water Levels: NOAA tide stations across US coasts and the Great Lakes: high and low tide predictions, observed water levels and current station weather (water and air temperature, wind, pressure).'
paths:
  /v1/tides/stations-near:
    get:
      operationId: tides__stations_near
      summary: 'US Tides & Water Levels: Tide stations near a point'
      description: 'NOAA tide-prediction stations within a radius (default 50 km) of a point, nearest first. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - tides
      externalDocs:
        url: https://fourzerotwo.si/apis/tides/stations-near
      parameters:
      - name: lat
        in: query
        required: true
        description: Latitude
        schema:
          type: string
          maxLength: 12
        example: '37.8'
      - name: lng
        in: query
        required: true
        description: Longitude
        schema:
          type: string
          maxLength: 12
        example: '-122.45'
      - name: radius_km
        in: query
        required: false
        description: Radius in km (default 50)
        schema:
          type: integer
        example: 30
      - name: limit
        in: query
        required: false
        description: Max results (default 10)
        schema:
          type: integer
        example: 5
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: tides__stations-near
    servers:
    - url: https://fourzerotwo.si
  /v1/tides/search:
    get:
      operationId: tides__search
      summary: 'US Tides & Water Levels: Find tide stations'
      description: 'Search NOAA tide stations by name and/or state. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - tides
      externalDocs:
        url: https://fourzerotwo.si/apis/tides/search
      parameters:
      - name: name
        in: query
        required: false
        description: Station name contains
        schema:
          type: string
          maxLength: 60
        example: Boston
      - name: state
        in: query
        required: false
        description: 2-letter state
        schema:
          type: string
          maxLength: 2
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: tides__search
    servers:
    - url: https://fourzerotwo.si
  /v1/tides/station:
    get:
      operationId: tides__station
      summary: 'US Tides & Water Levels: Tide station details'
      description: 'A station''s location, time zone, products offered and tidal datums. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - tides
      externalDocs:
        url: https://fourzerotwo.si/apis/tides/station
      parameters:
      - name: station
        in: query
        required: true
        description: NOAA CO-OPS station id
        schema:
          type: string
          maxLength: 12
        example: '9414290'
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: tides__station
    servers:
    - url: https://fourzerotwo.si
  /v1/tides/predictions:
    get:
      operationId: tides__predictions
      summary: 'US Tides & Water Levels: High and low tides'
      description: 'Predicted high and low tide times (local) and heights for up to 7 days from today. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - tides
      externalDocs:
        url: https://fourzerotwo.si/apis/tides/predictions
      parameters:
      - name: station
        in: query
        required: true
        description: NOAA CO-OPS station id
        schema:
          type: string
          maxLength: 12
        example: '9414290'
      - name: days
        in: query
        required: false
        description: Days (1–7, default 2)
        schema:
          type: integer
        example: 2
      - name: datum
        in: query
        required: false
        description: MLLW (default) | MLW | MSL | MHW | MHHW | NAVD
        schema:
          type: string
          maxLength: 5
      - name: units
        in: query
        required: false
        description: metric (default) | english
        schema:
          type: string
          maxLength: 8
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: tides__predictions
    servers:
    - url: https://fourzerotwo.si
  /v1/tides/water-level:
    get:
      operationId: tides__water_level
      summary: 'US Tides & Water Levels: Observed water level'
      description: 'Observed 6-minute water levels for the last hours (default 6, max 72) with the latest reading. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - tides
      externalDocs:
        url: https://fourzerotwo.si/apis/tides/water-level
      parameters:
      - name: station
        in: query
        required: true
        description: NOAA CO-OPS station id
        schema:
          type: string
          maxLength: 12
        example: '9414290'
      - name: hours
        in: query
        required: false
        description: Hours back (default 6)
        schema:
          type: integer
        example: 3
      - name: datum
        in: query
        required: false
        description: MLLW (default) | MLW | MSL | MHW | MHHW | NAVD
        schema:
          type: string
          maxLength: 5
      - name: units
        in: query
        required: false
        description: metric (default) | english
        schema:
          type: string
          maxLength: 8
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: tides__water-level
    servers:
    - url: https://fourzerotwo.si
  /v1/tides/conditions:
    get:
      operationId: tides__conditions
      summary: 'US Tides & Water Levels: Station conditions now'
      description: 'Latest water temperature, air temperature, wind and air pressure reported at a station (whichever it measures). Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - tides
      externalDocs:
        url: https://fourzerotwo.si/apis/tides/conditions
      parameters:
      - name: station
        in: query
        required: true
        description: NOAA CO-OPS station id
        schema:
          type: string
          maxLength: 12
        example: '9414290'
      - name: units
        in: query
        required: false
        description: metric (default) | english
        schema:
          type: string
          maxLength: 8
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: tides__conditions
    servers:
    - url: https://fourzerotwo.si
components:
  responses:
    PaymentRequired:
      description: x402 payment required. The body (also base64 in the PAYMENT-REQUIRED header) lists accepted payments.
      headers:
        PAYMENT-REQUIRED:
          schema:
            type: string
          description: Base64 JSON x402 v2 PaymentRequired
      content:
        application/json:
          schema:
            type: object
            properties:
              x402Version:
                type: integer
              error:
                type: string
              accepts:
                type: array
                items:
                  type: object
    Error:
      description: 400 = invalid input, 404 = not found at the source, 502 = the source failed. Never charged.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              charged:
                type: boolean
  securitySchemes:
    freeKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Optional free key (fzt_…) for the free tier.
x-refined-from:
- openapi.json
- fourzerotwo-si-openapi.json