{"uid":"cap_8tOG43_VnHmMfH8E7JeKZ","slug":"longwatch-watch-alerts-poll-39873541","name":"Longwatch Watch Alerts Poll","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/%7Bid%7D/alerts?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"watch_id returned by POST /watches"}}},"queryParams":{"type":"object","required":["key"],"properties":{"key":{"type":"string","description":"watch key returned at creation"},"since":{"type":"number","description":"cursor: highest alert seq already seen (0 on first poll)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"alerts":[{"seq":7,"form":"8-K","kind":"filing"}],"cursor":7,"status":"active","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_-oKStcGKuSchB2hgV_6Kl","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":"Poll a standing watch for new alerts (SEC filings, page changes, RSS items, crypto prices) since a given cursor position","exampleAgentPrompt":"Check my longwatch watch abc123 for any new alerts since the last one I saw (sequence 7) — use watch key xyz789.","exampleUseCases":[{"title":"Insider trade monitoring for portfolio","prompt":"Check my longwatch watch for Tesla for any new Form 4 insider trade filings since sequence 12 — my watch ID is w_5b2e and key is k_abc."},{"title":"8-K earnings alert for trading agent","prompt":"Poll my longwatch watch w_9f3a (key: k_qrs) for any new 8-K alerts since the last one at sequence 4 — I want to know if any material events have been filed."},{"title":"Crypto price watch for automated rebalancing","prompt":"Has my crypto price watch (ID: w_7d1c, key: k_mno) triggered any new alerts since sequence 0? I just set it up and want to see if there's anything yet."}],"resultDescription":"Returns a list of new alerts since the given cursor, each with a sequence number, alert kind (e.g. 'filing'), and form type (e.g. '8-K', 'Form 4'). Also returns the new cursor value to use on the next poll and the current watch status (e.g. 'active').","failureModes":["Invalid or expired watch_id returns 404 or empty alerts","Missing or wrong watch key returns 401 unauthorized","Since cursor higher than latest sequence returns empty alert list","Watch has been cancelled or expired, status field reflects this","Network or payment failure results in no response or 402 payment required"],"whenToPreferThis":"Use this endpoint when you have already created a standing watch via POST /watches and need to retrieve accumulated alerts between agent runs. This is the correct polling endpoint when you have a watch_id and key and want incremental updates since a known cursor — not for one-shot lookups (use the snapshot endpoint instead).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T06:30:08.024Z","isFirstParty":false,"canonicalSlug":"longwatch-watch-alerts-poll-39873541"}