watchers

WATCHER: get a signed callback when USGS reports a new...

WATCHER: get a signed callback when USGS reports a new earthquake near a location above a magnitude. Arm once, pay once. Pass lat, lon, optional radiusKm (default 500) and minMagnitude (default 4). Fires once per new quake (deduped by id); bounded by maxFires/expiry. Quakes already in the window at arm time are baselined. Free public-domain (USGS). Signed + retried; recoverable via watchers.status. Returns a watcherId.

post/api/watchers/earthquake

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/watchers/earthquake
  • Auth: API key in header PAYMENT-SIGNATURE

Request body

latnumber required

Latitude of the center point.

lonnumber required

Longitude of the center point.

radiusKmnumber

Search radius in km (default 500).

minMagnitudenumber

Minimum magnitude to fire on (default 4).

callbackUrlstring uri required

Signed event POSTed here (verify X-2s-Signature). Any http(s) URL.

payloadobject

Arbitrary JSON echoed back in every callback.

expiresInSecondsinteger

Active window in seconds (default 30d, max 90d).

maxFiresinteger

Stop after this many quakes (default 25).

labelstring

Optional free-text tag.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.