Tool reference
41 tools across 13 datasets. Each is callable over MCP (tools/call) and most have a REST mirror. Click any tool for its parameters, credit cost, and runnable examples.
Institutional-action intelligence#
Capital rotation#
capital_rotation12 crTHE 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). Cost: 12 credits per call.get_smart_money_leaderboard5 crWhich 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. Cost: 5 credits per call.get_ticker_confluence10 crFor 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. Cost: 10 credits per call.Funds & holdings (13F)#
fund.list1 crList 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. Cost: 1 credit per call.fund.holdings1 crLatest 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. Cost: 1 credit per call.fund.holdings.as_of5 crPoint-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. Cost: 5 credits per call.fund.position.history2 crTime-series of a single security position (by ticker or CUSIP) across a fund's filings — shares and USD value per quarter. Cost: 2 credits per call.fund.holdings.diff3 crQuarter-over-quarter change set for a fund's most recent filing: new positions, adds, reduces, exits, and reviewed reporting-universe changes. Each entry in `changes.new` carries `newly_reportable`: true means the SECURITY first appears in 13F filings this quarter (an IPO, direct listing or spin-off) and several other funds report it too, so the stake became reportable rather than being bought — report those separately from purchases; null means we could not determine it. Cost: 3 credits per call.stock.owners2 crInstitutional (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. Cost: 2 credits per call.Copy trading#
copy.leaderboard1 crRank 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. Cost: 1 credit per call.copy.target.get1 crGet 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. Cost: 1 credit per call.Insider trades (Form 4)#
insider.transactions1 crInsider (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. A ticker names ONE issuer: the SEC CIK with the newest Form 4 under that symbol, read across every symbol that issuer has filed with (filers type the symbol, and symbols get reused); `issuer_resolution` says which issuer answered and whose rows under the symbol were left out. Pass `issuer_cik` to read a specific issuer instead. Cost: 1 credit per call.insider.filing1 crOne 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. Cost: 1 credit per call.insider.company3 crNet 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?' The ticker resolves to ONE issuer, the SEC CIK with the newest Form 4 under that symbol, and the window covers every filing by that issuer whatever symbol the filer typed; `issuer_resolution` names it and any other issuer whose rows share the symbol. Pass `issuer_cik` to pin a specific issuer. Cost: 3 credits per call.insider.clusters5 crMarket-wide insider cluster scan: companies where several distinct insiders made open-market buys (or sells) inside a window — the high-conviction cluster signal. Each cluster names who traded (`who`: "CEO, CFO + 3 directors", plus a `buyers` roster with role, dollars, shares and `stake_change_pct`: shares bought as a share of what that insider already held, from the filing's own post-transaction balance), the largest buyer, and per-day `activity`. Ranked by distinct-insider count, then total value. Clusters that are an allocation rather than independent open-market decisions (every purchase at one price on one day, or an issuer whose first Form 4 on record is within 14 days of the buys: IPO allocations, placements, offerings) are returned separately as `offering_clusters`, never inside `clusters`. Cost: 5 credits per call.Congress (STOCK Act)#
congress.disclosures.listfreeList 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. Free (0 credits).congress.member.searchfreeFind 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). Free (0 credits).congress.tradesfreeParsed 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`. Free (0 credits).FDA & biotech catalysts#
clinicaltrials.search2 crUpcoming 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. Cost: 2 credits per call.fda.approvals2 crFDA 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. Cost: 2 credits per call.fda.recalls2 crFDA 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. Cost: 2 credits per call.pharma.resolve1 crResolve 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. Cost: 1 credit per call.Filings & watchlist#
events.latest1 crLive 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. Cost: 1 credit per call.watchlist.addfreeStart watching a company or a fund for THIS workspace, so new SEC filings on it surface later without anyone asking again. Use it the moment a user shows ongoing interest in a name — after a capital_change_brief, an insider lookup, or an explicit 'keep an eye on this'. Watched tickers are what watchlist.poll returns, and they drive the email alerts on the account. Free, no credits. Offer it rather than assuming it.watchlist.removefreeStop watching a company or fund for this workspace. Idempotent — removing something not being watched is not an error. Free, no credits.watchlist.listfreeEverything this workspace is currently watching, with when each watch started and its email-alert setting. Free, no credits. Read this before adding, so you do not offer to watch something already being watched.watchlist.poll1 crPoll 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. Add names with watchlist.add. Standard (delayed, ≤24h-old) freshness; each event carries its SEC source URL. Cost: 1 credit per call.watchlist.poll.live3 crLike 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. Cost: 3 credits per call.Signals & cross-source joins#
signal.trending5 crStocks trending on SEC filings, not prices or page views: the ranking behind https://arkolith.com/trending. Blends four measured signals, each z-scored against its own distribution in the window: qualified insider buy clusters (2+ distinct open-market buyers, $10K+ each), open-market insider trade surges (3+ Form 4 buys/sells at 2x the name's own 90-day pace; awards, exercises and tax withholding never count), 13F holder momentum (quarter over quarter) and rising Google search interest. Every row carries per-signal evidence numbers and plain-English reasons, strongest first. Cost: 5 credits per call.signal.crowding5 crCross-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. Served from the consensus snapshot the refresh-signals cron rebuilds twice daily (computed_at and snapshot_age_hours in the response); never computed live, and refused uncharged if the snapshot is older than 26h. Cost: 5 credits per call.signal.confluence10 crThe 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). Cost: 10 credits per call.Prediction markets#
predictionmarket.list1 crList prediction-market contracts with implied probabilities, from Polymarket and/or Kalshi. Optional keyword filter. Cost: 1 credit per call.predictionmarket.quote1 crGet a single prediction-market contract's implied probability by platform + id (Polymarket slug or Kalshi ticker). Cost: 1 credit per call.divergence.scan5 crCross-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. Cost: 5 credits per call.Macro (FRED)#
Search & provenance#
search1 crResolve 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. Cost: 1 credit per call.provenance.get1 crTrust layer: return the source record(s) for a datapoint — origin URL, fetch time, parser version — so the agent can cite primary sources. Cost: 1 credit per call.Account (free)#
account.balancefreeFREE (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.feedback.submitfreeFREE (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.