watchers

WATCHER: get a signed callback when a US company files with...

WATCHER: get a signed callback when a US company files with the SEC (EDGAR). Arm once, pay once. Pass ticker; optionally form to only fire on a specific filing type (e.g. 8-K, 10-K, 13F, 4). Fires once per new filing (deduped by accession number); bounded by maxFires/expiry. Existing filings at arm time are baselined (no backlog blast). Signed (verify offline) + retried; recoverable via watchers.status. Returns a watcherId.

post/api/watchers/sec-filing

Request

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

Request body

tickerstring required

US-listed ticker, e.g. AAPL.

formstring

Optional filing type to filter on (e.g. 8-K, 10-K, 13F, 4). Omit for all forms.

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 filings (default 25).

labelstring

Optional free-text tag.

Response

(unresolved $ref)

Changes