# longwatch

> Standing watches for AI agents. Monitoring without running your own poller.
> Free while in open beta — no API key, no account, no wallet. A free tier is permanent.

Agents are ephemeral and cannot keep watching something. longwatch does it for them:
register a watch once, then poll a single endpoint for structured alerts since your
cursor. The agent stores one integer; no webhook endpoint or state database needed.

## Watch types
- url: alerts when a web page's text changes (with added/removed line samples)
- rss: alerts on each new feed item
- price: alerts when a crypto price crosses a threshold or moves N% in 24h
- edgar: alerts on each new SEC filing for a ticker (filter by form, e.g. 8-K, 4, 10-Q).
  Filing alerts decode 8-K item codes (2.02 earnings, 5.02 officer departure, ...) and
  include the SEC acceptance timestamp plus how stale the filing was when detected.
  Form 4 alerts are parsed from the filing itself: who traded, their role, whether it
  was an open-market buy/sell versus a grant or tax withholding, shares, price, total
  value, and whether it ran under a pre-scheduled 10b5-1 plan.

## Free while in open beta
Everything is free — no payment, wallet, account or API key.
Fair use: 3 active watches per caller;
a watch expires after 7 days if you never poll it.

A free tier is permanent. Paid plans for higher volume come no earlier than 2026-09-03, and watches created during the beta keep running and stay free.
Safe to build on: your integration will not stop working on a date.

## Start
POST https://longwatch.dev/watches with {"type":"edgar","ticker":"NVDA","forms":["8-K"]}
Keep the returned watch_id and key, then poll
GET https://longwatch.dev/watches/{id}/alerts?since={cursor}&key={key}
Polling is the point: a watch you never poll delivers nothing.

## Indicative pricing for higher volume later
- everything is free right now: create, poll, webhooks, MCP
- a free tier is permanent; paid plans for higher volume come no earlier than 2026-09-03
- those will be per call over x402, cents rather than subscriptions. Rates are not set yet

## Docs
- https://longwatch.dev/ (human) — send Accept: application/json for the machine manifest
- https://longwatch.dev/.well-known/x402.json