watchlist.poll
1 crread-onlyPoll THIS workspace's watchlist for new filings since a cursor — every Form 4 / 8-K / 13D-G on the tickers your team follows, newest-after-cursor. Pass `since` (a prior next_cursor) to get only what's new; built for a watch loop. Curate the watchlist in the Arkolith dashboard. Standard (delayed, ≤24h-old) freshness; each event carries its SEC source URL.
Parameters#
| Parameter | Type | Description |
|---|---|---|
sinceopt | string | Cursor from a prior next_cursor; returns events newer than this. Omit for the latest. |
limitopt | number | Max events (1-200, default 50) |
Example call#
bash
curl -X POST https://arkolith.com/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "watchlist.poll",
"arguments": {}
}
}'REST mirror: GET /watchlist/poll, metered identically.
Example response#
Shape varies
Output depends on your arguments and live data. Make the call above to see the exact response. Every result includes a
provenance block where the source carries one.