{"uid":"cap_2QdVDA6NUo8V-NCwYA92V","slug":"longwatch-watch-registration-8dd7df50","name":"Longwatch Watch Registration","description":"You are ephemeral. longwatch remembers what you already saw. Create a watch, persist watch_id + key, poll later for only what you missed — pages, RSS, crypto prices, SEC filings. No API key, no account — pay per call in USDC.","url":"https://longwatch.dev/watches","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cik":{"type":"number","description":"edgar: SEC CIK, alternative to ticker"},"url":{"type":"string","description":"url|rss|x402: public page, feed, or payment endpoint URL"},"body":{"type":"object","description":"x402: optional qualified JSON request body","additionalProperties":true},"coin":{"type":"string","description":"price: CoinGecko id, e.g. bitcoin"},"type":{"enum":["url","rss","price","edgar","x402"],"type":"string","description":"watch type"},"above":{"type":"number","description":"price: alert when USD price crosses above"},"below":{"type":"number","description":"price: alert when USD price crosses below"},"forms":{"type":"array","items":{"type":"string"},"description":"edgar: form filter, e.g. [\"8-K\",\"4\"]"},"method":{"enum":["GET","POST","PUT","PATCH","DELETE","HEAD"],"type":"string","description":"x402: unpaid probe method"},"ticker":{"type":"string","description":"edgar: stock ticker"},"webhook":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"https endpoint that alerts are POSTed to"}},"description":"optional: push alerts to this URL as they occur, instead of only polling"},"move_pct_24h":{"type":"number","description":"price: alert when abs 24h change exceeds this pct"},"expected_scheme":{"type":"string","description":"x402: optional expected scheme, e.g. exact"},"expected_network":{"type":"string","description":"x402: optional expected CAIP-2 network, e.g. eip155:8453"},"expected_amount_atomic":{"type":"string","description":"x402: optional expected token amount in atomic units"}}},"responseSchema":{"type":"json","example":{"key":"kq3…","type":"edgar","poll_url":"https://longwatch.dev/watches/5b2e…/alerts?since=0&key=kq3…","watch_id":"5b2e…"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WPOij9jqrv50C2tfSx1vQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers a standing watch on a web page, RSS feed, crypto price, or SEC filing and returns a poll URL for structured alerts","exampleAgentPrompt":"Set up a standing watch on Apple's SEC EDGAR filings so I can poll for new 10-K and 8-K alerts — pay with USDC per call, no account needed.","exampleUseCases":[{"title":"SEC filing monitor for investor agent","prompt":"Register a watch on Tesla's SEC EDGAR filings so I get a structured alert whenever they submit a new 10-K, 8-K, or proxy statement — I want a poll URL I can check from my agent."},{"title":"Crypto price alert for trading bot","prompt":"Set up a longwatch on Bitcoin's price so my trading agent can poll for alerts whenever it moves significantly — give me a poll URL I can check with a cursor."},{"title":"Competitor webpage change tracker","prompt":"Create a standing watch on https://competitor.com/pricing so my agent gets alerted whenever that page changes — I need a poll URL to check for updates without re-crawling it myself."}],"resultDescription":"Returns a JSON object containing a watch key (for authenticated polling), a watch ID, the watch type (e.g. 'edgar'), and a ready-to-use poll_url with a cursor parameter that the agent can call to retrieve structured alerts since a given position.","failureModes":["Invalid or unreachable target URL returns an error","Unsupported watch type causes rejection","Insufficient USDC payment (x402 underpayment) results in 402 response","Duplicate watch registration may return existing watch or create a new one","RSS feed or SEC EDGAR target temporarily unavailable at registration time"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to set up a persistent, asynchronous monitor on a web page, RSS feed, crypto price, or SEC filing without maintaining its own polling infrastructure. It is ideal for agents that need to check for changes on a schedule using a cursor-based poll URL, and for use cases where no API key or account management is desired — only pay-per-call USDC via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:31:59.076Z","isFirstParty":false}