io.github.wikatar/arkolith

FREE (0 credits). Return this API key's credit balance (free + paid), USD value, and top-up URL. Call this to self-monitor before/after spending — checking your balance never costs credits.

Compose the current evidence-backed capital-change brief for one ticker. Use when a user asks what changed in reported institutional ownership, which tracked managers drove it, whether qualifying Form 4 open-market activity points in the same or opposite direction, and wants the SEC proof. Current-only: pass ticker only; as_of and since are not supported. Returns an explicit outcome and coverage, manager changes, insider activity, corroboration, filing evidence, and a derivation manifest. When direction is withheld, read quality_artifacts for bounded, machine-readable reasons and hidden-row examples. Every evidence ID on an artifact example has a rich object in evidence; manifest.evidence_ids is the complete aggregate set, and the corroboration claim points to it through evidence_reference. Lead with the headline, counts, largest drivers, Form 4 stance, and coverage. Cite relevant human_url evidence links. 13F changes are reported quarter-end positions, not trade dates, real-time flows, intent, or investment advice.

THE flagship 'where is smart money rotating' signal. Aggregates quarter-over-quarter SEC 13F position changes across ALL tracked institutions into per-SECTOR capital flows: which sectors institutions are net BUYING into vs SELLING out of this quarter, with breadth (how many funds agree), net flow as % of the sector's book, and a rotation rank. Price-free, point-in-time, every number traced to 13F. Answers 'is smart money rotating out of tech into energy/utilities, and is it broad-based?' — what the sell-side ships as a static quarterly PDF. Pass `period` (ISO quarter-end) for a specific quarter, else the latest well-covered one. NOT investment advice; backward-looking (13F lags ~45 days).

Upcoming clinical-trial readout catalysts. For an industry-sponsored interventional Phase 2/3 drug trial, an ESTIMATED primaryCompletionDate is the expected topline-readout date — the binary event that re-rates a biotech ticker. Filter by sponsor (lead sponsor, INDUSTRY class), condition, phase, and a readout-date window; sorted soonest-first. Returns NCT id, title, phase, status, lead sponsor + resolved ticker (null if private/foreign), conditions, primary completion date (+ ACTUAL/ESTIMATED), and a study URL. CAVEAT: estimated dates are sponsor-self-reported and SLIP often — a readout WINDOW, not a hard date; press releases beat this feed. Public-domain ClinicalTrials.gov v2.

List the US House financial-disclosure filing INDEX for a year (STOCK Act). filingType 'P' = Periodic Transaction Report (stock trades). Returns one row per filing with a link to the source PDF — this is the index, NOT parsed trades. Parsed line-items (member, ticker, buy/sell, amount range) are available via congress.trades (US House live; Senate being added). Public-domain US House Clerk data.

Find US House representatives who filed financial disclosures in a year, by name (filing index — parsed trades available via congress.trades, US House live; Senate being added).

Parsed STOCK Act transaction line-items: actual congressional stock trades by ticker or by member — buy/sell, the disclosed amount range, trade + notification dates, and owner (self/spouse). Each row links to its source PTR PDF. US House (e-filed) is live; Senate is being added. Pass `ticker` OR `member`.

Rank the institutional managers (13F funds) worth copying. Each row is a followable actor — name, manager, book size (AUM), holdings count, latest reported quarter, follower count, the slug (for copy.target.get), and CIK (to follow via watchlist / pull via fund.holdings). Price-derived copy-return fields are withheld unless the price-source policy and freshness gate are green. The agent-native 'who should I copy?' entry point. Sort by book size, recent activity, follower count, or gated track record. Public-domain SEC EDGAR 13F data.

Get one copy target (13F fund) by slug (from copy.leaderboard): its latest disclosed book — the top holdings you'd mirror, each with % of book and its quarter-over-quarter change (NEW/ADDED/REDUCED/EXITED) — plus book size, latest quarter, and filing history. Pair with watchlist tools to follow it. Public-domain SEC EDGAR 13F data.

Cross-market divergence: for a topic keyword, pull matching contracts from Polymarket and Kalshi and compare implied probabilities to surface potential mispricing/arb. Note: matches are keyword-correlated, not verified same-event — confirm the contracts describe the same outcome before trading.

Live SEC filing-event stream: SEC Form 4 (insider) filings today, with 8-K and 13D/G on the roadmap. Poll with `since` (a monotonic cursor) to get every filing newer than your last call; the response's next_cursor advances it. Filter by form or tickers; a form we don't carry yet returns an explicit unsupported_form note (never a silent empty page). Built for a watch loop, so call it on a schedule to never miss a filing.

FDA drug-approval / rejection actions (Drugs@FDA, CDER). For a sponsor or drug, returns the regulatory action history: action=approved (AP, bullish), complete_response_letter (CR, a rejection — sharply bearish), or tentative_approval (TA). Flags new molecular entities (NME) and priority review — the highest-value catalysts. Resolves sponsor_name to a ticker (null if private). CAVEAT: backward-looking (records actions AFTER they happen, lags days; press releases beat it) — a confirmation/archive feed. Drugs@FDA is CDER-only, so biologics/vaccines (e.g. Moderna) may be absent. Public-domain openFDA.

FDA drug recalls (Recall Enterprise System). Class I = could cause death/serious harm (material adverse event); Class II/III lower. Filter by recalling firm, drug, classification, and recency; returns classification, reason, status, dates, and the recalling firm's resolved ticker (null if private). CAVEAT: enforcement data updates only WEEKLY and FDA does not revise recall status after classification — can be stale/frozen; not for real-time alerting. Public-domain openFDA.

FREE (0 credits). Tell the Arkolith team what data you wish existed, report wrong/missing data, or suggest an improvement. For capital_change_brief, call this only after the user explicitly says the delivered answer was useful or says what was missing; include workflow, brief_id, ticker, and verdict. Arkolith verifies an OK delivery receipt for this organization and API key, and records at most one verdict per organization and brief. Duplicate submissions return already_recorded=true. Never infer usefulness from a technically successful result.

Latest reported 13F equity holdings for a fund (by SEC CIK) — top positions by value, each with its CUSIP and quarter-over-quarter change (new/added/reduced/exited). Public-domain SEC EDGAR data.

Point-in-time 13F holdings as publicly knowable at a cutoff, selected by the SEC acceptance timestamp with no filing-date fallback. YYYY-MM-DD means end-of-day UTC; timestamps must include a timezone. This is source-publication replay, not a claim about when Arkolith first stored or served the filing.

Quarter-over-quarter change set for a fund's most recent filing: new positions, adds, reduces, exits, and reviewed reporting-universe changes.

List the institutional managers (hedge funds, asset managers) that file SEC 13F reports, ranked by AUM. Returns each fund's name, AUM, latest reported quarter, holdings count, and its SEC CIK — the id you pass to fund.holdings, fund.holdings.diff, fund.holdings.as_of, and fund.position.history. Start here to find which funds to track. Public-domain SEC EDGAR data.

Time-series of a single security position (by ticker or CUSIP) across a fund's filings — shares and USD value per quarter.

Which disclosed 13F books are most focused? Ranks eligible institutional funds by a PRICE-FREE score: breadth-adjusted top-10 focus (40%), reported book growth (20%), and evidence-adjusted insider co-buy (40%). A 10-name book has neutral focus evidence, exact ties share a rank input, and sparse co-buy samples shrink toward the quarter baseline with 10 prior observations. Holding count has no independent weight. Universe: positively classified conviction filers only (hedge fund, private equity, family office, holding company); unclassified, mechanical, wealth, pension, endowment, and quant/multi-strat books are never served here. The score is NOT realized track record/performance. Sort by overall score, focus, insider corroboration, or AUM growth. PRICE-FREE; NOT investment advice.

For ONE ticker: do the independent disclosure sources AGREE? Returns the cross-source confluence verdict — institutions (13F) × insiders (Form 4) × Congress (STOCK Act) all buying/selling the same name — PLUS the capital-rotation context: which sector the ticker is in and whether smart money is rotating INTO or OUT of that sector this quarter. The two flagship signals on one name. Congress is a free corroborating leg (never the sole basis). PRICE-FREE; NOT investment advice.

Market-wide insider cluster scan: companies where several distinct insiders made open-market buys (or sells) inside a window — the high-conviction cluster signal. Returns tickers ranked by distinct-insider count and total value.

Net insider activity for one company over a window: open-market buy vs sell value/shares and distinct buyer/seller counts. Answers 'are insiders net buying or selling this name right now?'

One SEC Form 4 filing by accession number: the reporting insider, issuer, and every transaction in it (non-derivative + derivative), with net open-market flow and a link to the original SEC document. The full-filing follow-up when insider.transactions or events.latest hands you an accession_number.

Insider (SEC Form 4) transactions — open-market buys/sells, awards, option exercises — for a company (by ticker) or a person (by insider name). Pass `signal: true` to restrict to open-market buys/sells (codes P/S), the tradeable subset. Pass `since` to diff only new filings.

Get recent observations for a macro/economic time series from FRED (e.g. GDP, CPIAUCSL, DGS10, UNRATE).

Search FRED for macro/economic time series by keyword; returns matching series IDs and titles.

Resolve a pharma sponsor / manufacturer name (e.g. 'Janssen Pharms', 'AstraZeneca AB') to its public ticker, so an FDA approval / trial readout / recall can be joined to 13F ownership, insider (Form 4) buys, and the confluence signal. Returns ticker, company name, exchange, and resolution method (alias|exact|fuzzy|unresolved). Returns ticker:null for private sponsors or unmatched names rather than guessing — joins must never key on a wrong ticker.

List prediction-market contracts with implied probabilities, from Polymarket and/or Kalshi. Optional keyword filter.

Get a single prediction-market contract's implied probability by platform + id (Polymarket slug or Kalshi ticker).

Trust layer: return the source record(s) for a datapoint — origin URL, fetch time, parser version — so the agent can cite primary sources.

Resolve a name to a tracked entity. Turn a fund or manager name (e.g. 'Berkshire', 'Citadel') into the SEC CIK or slug you pass to the fund.* tools — the entity-resolution entry point. Searches funds and managers by name or identifier.

The moat join — where do informed INSIDERS (Form 4 open-market buys), institutional SMART MONEY (13F cluster-buys), and CONGRESS (US House STOCK Act trades) AGREE? Pass a `ticker` for all three legs on one name (insider + fund + congress net buy/sell + a verdict that escalates to triple_confluence_buy when all three are buying). Omit `ticker` for the market-wide ranked list — insider×fund names, surfaced first when Congress is buying too (triple_confluence). Joined on ticker — never a fuzzy name match. Each leg carries source provenance; congress $ are amount-range midpoints (approximate).

Cross-fund 'smart money' consensus from every tracked fund's latest 13F: the securities the MOST funds are collectively holding (mode='held'), buying this quarter (mode='bought' — NEW/ADDED cluster-buys), or selling (mode='sold' — REDUCED). The inverse of stock.owners: surfaces WHAT to look at, ranked by how many funds agree.

Institutional (13F) owners of a stock by ticker — which funds hold it, position value, share count, and the quarter-over-quarter change. The 'who owns this stock' join across all tracked funds.

Poll THIS workspace's watchlist for new filings since a cursor: every SEC Form 4 (insider) filing on the tickers your team follows, newest-after-cursor (8-K + 13D/G are on the roadmap). 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.

Like watchlist.poll but LIVE freshness — includes filings accepted within the last 24h (minute-fresh, normalized within minutes of SEC acceptance). Premium-priced and requires the Developer or Pro plan; other plans poll delayed (≤24h-old) freshness via watchlist.poll. Same workspace-watchlist scope and cursor semantics.