Tool reference
40 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).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.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.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.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.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.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.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.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.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.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.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.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.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?'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. Returns tickers ranked by distinct-insider count and total value.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.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).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`.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.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.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.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.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.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.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.Signals & cross-source joins#
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.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).Prediction markets#
predictionmarket.list1 crList prediction-market contracts with implied probabilities, from Polymarket and/or Kalshi. Optional keyword filter.predictionmarket.quote1 crGet a single prediction-market contract's implied probability by platform + id (Polymarket slug or Kalshi ticker).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.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.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.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.