# 2s.io Tide Predictions

> 2s.io Tide Predictions is a paid API for AI agents from 2s.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Returns next high and low tide predictions near a geographic coordinate, using the nearest NOAA tide station within a configurable radius.

## Facts

- Endpoint: GET https://2s.io/api/tides/now
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-1475c25e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uCAQOb7p_zCUgHy6JMGui

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-io-1475c25e
```

Example prompt: What are the high and low tide predictions for the next 48 hours near latitude 37.8 and longitude -122.4, looking within 75 km for a NOAA station?

## When to prefer this

Use this endpoint when you need official NOAA tide predictions (high/low times and heights in meters referenced to MLLW) near a specific geographic coordinate. Prefer it over generic weather APIs when tidal data specifically is required, especially for marine, coastal, fishing, surfing, or navigation use cases. It is particularly useful when you need the nearest NOAA station automatically resolved rather than specifying a station ID manually.

## Known failure modes

- 404 NO_STATION — no NOAA tide station found within the specified radius; try increasing radius_km
- Invalid lat/lon values outside -90..90 / -180..180 range
- hours or radius_km outside allowed bounds (1-72 and 1-500 respectively)
- Coordinate is inland far from any coast — no stations will be found regardless of radius
- Payment failure or insufficient USDC balance (x402 protocol)

## How this service works

Next high/low tide predictions near a coordinate. Query: lat (-90..90), lon (-180..180), radius_km (1-500, default 100), hours (1-72, default 24). Returns { query, station:{ id, name, latitude, longitude, state, distanceKm }, predictions[{ time (station local), type: "high"|"low", heightMeters }], source }. Returns 404 NO_STATION if no NOAA tide station is within radius. Heights are referenced to MLLW (Mean Lower-Low Water).

## Output

Returns the matched NOAA tide station (id, name, lat/lon, state, distance in km), and an array of tide predictions each containing a local-time timestamp, type ('high' or 'low'), and height in meters referenced to MLLW (Mean Lower-Low Water). Also includes the original query parameters and source attribution.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "lat": 37.8,
   "lon": -122.4,
   "hours": 48,
   "radius_km": 75
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "maximum": 90,
       "minimum": -90
      },
      "lon": {
       "type": "number",
       "maximum": 180,
       "minimum": -180
      },
      "hours": {
       "type": "number",
       "default": 24,
       "maximum": 72,
       "minimum": 1
      },
      "radius_km": {
       "type": "number",
       "default": 100,
       "maximum": 500,
       "minimum": 1
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-1475c25e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)