REST API/watchlist-poll
GET

/watchlist/poll

1 cr

The recurring-revenue primitive. Poll the tickers THIS workspace follows for new filings since your last cursor: every Form 4 / 8-K / 13D-G, newest-after-cursor. freshness=delayed (default, ≤24h old) is weight 1; freshness=live is weight 3. Curate the watchlist in the dashboard.

Request#

bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://arkolith.com/api/v1/watchlist/poll?limit=10"

Parameters#

ParameterInTypeDescription
sincequerystringCursor from a prior next_cursor
freshnessquerystringdelayed = ≤24h old (1 cr), live = minute-fresh (3 cr)one of: delayedlivedefault: delayed
limitqueryintegerMax events (max 200)default: 50

Example response#

json
{
  "data": {
    "events": [
      {
        "seq": 4412,
        "form": "4",
        "ticker": "NVDA",
        "filed_at": "2026-06-06T20:14:00Z",
        "source_url": "https://www.sec.gov/Archives/edgar/data/..."
      }
    ],
    "next_cursor": "4412",
    "freshness": "delayed"
  }
}

MCP equivalent: watchlist.poll. The full agent surface lives on the MCP server.