{"openapi":"3.1.0","info":{"title":"longwatch","version":"1.0.0","description":"Standing watches for AI agents. Register a watch on a web page, RSS feed, crypto price, or SEC filings; poll one endpoint for structured alerts since your cursor. Free while in open beta — no API key, no account, no wallet.","contact":{"email":"contact@coinop.dev"},"x-guidance":"Use longwatch when something needs watching over time rather than checked once. Call create_watch to register a source (a web page, an RSS feed, a crypto price threshold, or a company's SEC filings), keep the returned watch_id and key, then call poll_alerts with since=<last cursor> whenever you want what's new. The service polls between your runs, so an agent that only exists briefly still learns what changed while it wasn't running. Filing alerts decode 8-K item codes and parse Form 4 insider trades into who bought or sold, how much, and whether it was a scheduled 10b5-1 trade.","x-use-cases":["alert me when a web page changes","monitor a competitor's pricing page for changes","watch a docs or status page for updates","detect when a government or regulatory page is updated","get notified about new items in an RSS feed","alert me when bitcoin crosses a price threshold","notify me when a crypto price moves more than 5% in a day","watch a company for new SEC filings","alert me when a company files an 8-K","tell me when a corporate insider buys or sells stock","track Form 4 insider transactions for a ticker","monitor something continuously without running my own server","keep watching a source between agent runs"]},"servers":[{"url":"https://longwatch.dev"}],"paths":{"/watches/{id}/credits":{"post":{"summary":"Buy delivery credits for a watch, so alerts continue being pushed to its webhook. Each purchase adds a fixed batch of de","description":"Buy delivery credits for a watch, so alerts continue being pushed to its webhook. Each purchase adds a fixed batch of deliveries. Free while in open beta — no payment, wallet or account required. 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. No API key, no account, no wallet, no subscription.","operationId":"post_watches__id__credits","tags":["monitoring","alerts","change-detection","website monitoring","page diff"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string","description":"watch key"}},"required":["key"]},"example":{"key":"kq3…"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"watch_id":"5b2e…","delivery_credits":50}}}}},"x-payment-info":{"authMode":"none","price":{"mode":"free","amount":"0","currency":"USD"},"note":"Free while in open beta — no payment, wallet or account required. 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."}}},"/watches":{"post":{"summary":"Create a standing watch. Types: url (page text diff), rss (new feed items), price (crypto threshold/24h-move via CoinGec","description":"Create a standing watch. Types: url (page text diff), rss (new feed items), price (crypto threshold/24h-move via CoinGecko id), edgar (new SEC filings by ticker+forms — 8-K item codes decoded, Form 4 insider trades parsed into who bought/sold, how much, and whether scheduled). Returns watch_id, key, and the poll URL. Poll GET /watches/{id}/alerts?since={cursor}&key={key} for alerts. Free while in open beta — no payment, wallet or account required. 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. No API key, no account, no wallet, no subscription.","operationId":"post_watches","tags":["monitoring","alerts","change-detection","website monitoring","page diff"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["url","rss","price","edgar"],"description":"watch type"},"url":{"type":"string","description":"url|rss: page or feed URL to watch"},"coin":{"type":"string","description":"price: CoinGecko id, e.g. bitcoin"},"above":{"type":"number","description":"price: alert when USD price crosses above"},"below":{"type":"number","description":"price: alert when USD price crosses below"},"move_pct_24h":{"type":"number","description":"price: alert when abs 24h change exceeds this pct"},"ticker":{"type":"string","description":"edgar: stock ticker"},"cik":{"type":"number","description":"edgar: SEC CIK, alternative to ticker"},"forms":{"type":"array","items":{"type":"string"},"description":"edgar: form filter, e.g. [\"8-K\",\"4\"]"},"webhook":{"type":"object","properties":{"url":{"type":"string","description":"https endpoint that alerts are POSTed to"}},"required":["url"],"description":"optional: push alerts to this URL as they occur, instead of only polling"}},"required":["type"]},"example":{"type":"edgar","ticker":"NVDA","forms":["8-K"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"watch_id":"5b2e…","key":"kq3…","type":"edgar","poll_url":"https://longwatch.dev/watches/5b2e…/alerts?since=0&key=kq3…"}}}}},"x-payment-info":{"authMode":"none","price":{"mode":"free","amount":"0","currency":"USD"},"note":"Free while in open beta — no payment, wallet or account required. 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."}}},"/watches/{id}/alerts":{"get":{"summary":"Poll a watch for alerts since a cursor. Pass since={last seq you saw}; the response carries a new cursor. Polling keeps ","description":"Poll a watch for alerts since a cursor. Pass since={last seq you saw}; the response carries a new cursor. Polling keeps the watch alive. Free while in open beta — no payment, wallet or account required. 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. No API key, no account, no wallet, no subscription.","operationId":"get_watches__id__alerts","tags":["monitoring","alerts","change-detection","website monitoring","page diff"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"watch_id returned by POST /watches"},{"name":"since","in":"query","required":false,"schema":{"type":"number"},"description":"cursor: highest alert seq already seen (0 on first poll)"},{"name":"key","in":"query","required":true,"schema":{"type":"string"},"description":"watch key returned at creation"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"watch_id":"5b2e…","status":"active","cursor":7,"alerts":[{"seq":7,"kind":"filing","form":"8-K"}]}}}}},"x-payment-info":{"authMode":"none","price":{"mode":"free","amount":"0","currency":"USD"},"note":"Free while in open beta — no payment, wallet or account required. 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."}}},"/mcp":{"post":{"summary":"MCP endpoint (Streamable HTTP) — same capabilities as the REST routes","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string","const":"2.0"},"id":{"type":["number","string"]},"method":{"type":"string","description":"initialize | tools/list | tools/call"},"params":{"type":"object","properties":{"name":{"type":"string","description":"tool name for tools/call"},"arguments":{"type":"object","description":"tool arguments"}}}},"required":["jsonrpc","method"]},"example":{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_watch","arguments":{"type":"edgar","ticker":"NVDA","forms":["8-K"]}}}}}},"description":"JSON-RPC MCP endpoint (Streamable HTTP). Free while in open beta — no payment, wallet or account required. 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. Tools: create_watch, poll_alerts, delete_watch. No API key, account or wallet required.","operationId":"mcp","tags":["mcp","monitoring","alerts","change-detection","website monitoring"],"responses":{"200":{"description":"JSON-RPC result"},"402":{"description":"Payment required"}},"security":[]}}},"x-tags":["monitoring","alerts","change-detection","website monitoring","page diff","sec-filings","edgar","insider trading","form 4","rss","price-alerts","web-monitoring","mcp"]}