StockFit API
StockFit is structured intelligence from SEC filings: normalized financials, institutional ownership flows, ETF exposure analysis, filing event timelines, and…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
StockFit is structured intelligence from SEC filings: normalized financials, institutional ownership flows, ETF exposure analysis, filing event timelines, and AI-classified business models. All sourced from official XBRL filings. Fully traceable to source documents. Updated daily.
Start here: build an investment research view in 3 calls
1. Get the company profile
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://api.stockfit.io/v1/api/company/details?symbol=AAPL"const profile = await fetch(
"https://api.stockfit.io/v1/api/company/details?symbol=AAPL",
{ headers: { Authorization: "Bearer YOUR_TOKEN" } }
).then(r => r.json());
// { name: "Apple Inc.", sector: "Technology", fiscalYearEndMonth: 9, ... }2. Pull 3 years of financials
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://api.stockfit.io/v1/api/financials/income-statement?symbol=AAPL&period=annual&limit=3"const financials = await fetch(
"https://api.stockfit.io/v1/api/financials/income-statement?symbol=AAPL&period=annual&limit=3",
{ headers: { Authorization: "Bearer YOUR_TOKEN" } }
).then(r => r.json());
// [{ period: "2025-09-26", facts: { revenue: 416161000000, netIncome: 112010000000, ... } }, ...]3. See who owns it
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://api.stockfit.io/v1/api/ownership/institutional-holders?symbol=AAPL&pageSize=5"const holders = await fetch(
"https://api.stockfit.io/v1/api/ownership/institutional-holders?symbol=AAPL&pageSize=5",
{ headers: { Authorization: "Bearer YOUR_TOKEN" } }
).then(r => r.json());
// { data: [{ managerName: "BlackRock, Inc.", shares: 1157054556, pctOfShares: 7.87 }, ...] }Financial structure. Ownership concentration. Decision-ready in seconds. Get your API token from the StockFit dashboard.
Go deeper
The 3 calls above give you fundamentals. These give you the edge:
- Research summary (
/api/company/research-summary): profile + earnings snapshot + key metrics in one call (Starter, Pro) - Economic model (
/api/company/economic-model): citation-verified business model: offerings, monetization, operating levers, moats, flywheels, failure modes (Stock, Pro) - Ownership summary (
/api/ownership/summary): institutional concentration, top holders, beneficial owners, insider count (Pro) - Fund exposure (
/api/fund/reverse-lookup): which ETFs and mutual funds hold this stock, sorted by position size (ETF, Pro) - Filing timeline (
/api/filings/timeline): recent filings + predicted next filings + earnings date (Pro)
What's inside
- Financials: as-reported + normalized statements (annual, quarterly, TTM) with per-value SEC filing lineage, growth rates, sector-aware key metrics, Piotroski & Altman scores, chart-ready series
- Footnotes: 17 structured datasets from the footnotes and schedules: revenue & business segmentation, per-tranche debt, credit facilities, leases, buybacks, pensions, concentration, workforce cost, and more
- Ownership & insiders: institutional holders (13F) with history, beneficial owners (13D/G), insider transactions (Form 3/4/5), share classes, manager portfolios
- ETFs & mutual funds: holdings (including daily), flows, overlap, composition, fees, performance, structural analysis, AI exposure models
- Earnings & dividends: EPS history, snapshots, multi-year trends, quality metrics, calendars, upcoming earnings and dividends
- SEC filings: search, 8-K event classification, section/item text extraction, S-1 offering pipeline, statistics, predicted filing calendar
- Company: profiles, AI peer comparables, stock splits, IPO calendar, delistings
- Executives: officers, compensation vs TSR, governance flags, company-selected KPIs (DEF 14A)
- Congress trades: House and Senate STOCK Act disclosures by company, by member, and market-wide
- Prices: delayed quotes and end-of-day close history, split-adjusted or unadjusted
- Symbols: lookup, search, batch, and CIK/CUSIP/FIGI cross-referencing
AI Integration (MCP)
StockFit supports the Model Context Protocol with OAuth 2.1 authentication. Sign in once in a browser, your AI client handles tokens automatically. No API keys to copy or rotate. Works with Claude Desktop, Claude Code, Cursor, VS Code, ChatGPT, and any MCP-compatible client.
{
"mcpServers": {
"stockfit": {
"type": "http",
"url": "https://api.stockfit.io/mcp"
}
}
}Same config for everyone, no API key needed. Your client opens a browser the first time you connect, you sign in, and tokens refresh automatically after that.
Full per-client setup (Claude Desktop, Claude Code, Cursor, VS Code): developer.stockfit.io/mcp.
What you can build
| … |
Endpoints 125
Symbol Lookup
- GETLookup by CIK
/api/lookup/cik?cik=320193!Free !Starter !Pro Returns enriched symbol profile for a given SEC Central Index Key. Works for stocks, ETFs, and mutual funds. - GETLookup by CUSIP
/api/lookup/cusip?cusip=037833100!Free !Starter !Pro Returns enriched symbol profile for a given CUSIP identifier. Works for stocks, ETFs, and mutual funds. - GETLookup by symbol
/api/lookup/symbol!Free !Starter !Pro Returns enriched profile (name, CIK, exchange, sector, industry, description, logo) for a given ticker symbol. - GETBatch lookup by symbols
/api/lookup/batch?symbols=AAPL,MSFT,GOOG!Free !Starter !Pro Returns enriched profiles for multiple ticker symbols in a single request. Up to 50 symbols per request. - GETLookup by Composite FIGI
/api/lookup/figi?figi=BBG000B9XRY4!Free !Starter !Pro Resolves a Bloomberg Composite FIGI to a full symbol profile with all identifiers. Composite FIGI is a security-level identifier, one per… - GETSearch by former company names
/api/lookup/former-names?searchString=Facebook!Free !Starter !Pro Finds companies that previously operated under a different legal name. Useful for tracking corporate rebrandings and name changes (e.g.… - GETSearch symbols
/api/lookup/search?searchString=Apple!Free !Starter !Pro Search-as-you-type over tickers and names. Ranking: exact ticker first, then ticker prefixes and names with a word starting with the… - GETNews by symbol
/api/lookup/news!Free !Starter !Pro Recent news headlines for a ticker symbol (stocks, ETFs, and mutual funds), aggregated from public news sources. Returns headline,… - GETGeneral US market news
/api/lookup/news/market!Free !Starter !Pro Top US market and business news headlines, merged from multiple public sources. Returns headline, publisher, publication timestamp, and a…
Symbol Lists
- GETList all symbols
/api/symbols!Free !Starter !Pro Paginated list of all supported ticker symbols (stocks, ETFs, and mutual funds) with enriched profile data. Filter by type, exchange,… - GETList exchanges
/api/symbols/exchanges!Free !Starter !Pro Returns the curated list of exchange names we standardize every listing to. Use any of these as the exchange filter on /api/symbols. - GETList sectors
/api/symbols/sectors!Free !Starter !Pro Returns all business sectors with the number of stocks in each. Sectors come from SFIC (StockFit Industry Classification), our proprietary… - GETList industries
/api/symbols/industries!Free !Starter !Pro Returns all distinct industries with the number of stocks in each. Industries come from SFIC (StockFit Industry Classification), our… - GETList industry groups (deprecated)
/api/symbols/industry-groupsDeprecated. !Free !Starter !Pro Deprecated. Use the SFIC-based /api/symbols/sectors and /api/symbols/industries taxonomy instead. This endpoint still returns…
Company
- GETCompany details
/api/company/details!Free !Starter !Pro Returns company profile including description, SIC industry/sector classification, fiscal year end, exchange listings, and contact address. - GETBatch company details
/api/company/details-batch?symbols=AAPL,MSFT,GOOGL!Starter !Pro Returns company profiles for multiple symbols in a single request. Same data as /details but keyed by symbol. Maximum 50 symbols per request. - GETResearch summary
/api/company/research-summary!Starter !Pro Compressed research endpoint: returns company profile, earnings snapshot (EPS, margins, returns, health scores, predicted dates), and… - GETPeers
/api/company/peers!Pro Returns up to 6 comparable public companies ("peers") for a stock, alongside the subject's own latest annual revenue so you can judge comparability.… - GETDelisted companies
/api/company/delisted!Free !Starter !Pro Paginated list of fully delisted public companies, stocks that no longer have an active listing on any exchange we track (neither a major… - GETStock Split History
/api/company/stock-splits!Pro Returns the full history of stock splits for a single company, sourced from XBRL footnote disclosures… - GETRecent stock splits
/api/company/recent-stock-splits!Pro Cross-company feed of recent stock splits across the entire SEC EDGAR universe, ordered by split date descending. Each entry attaches the company's… - GETUpcoming stock splits
/api/company/upcoming-stock-splits!Pro Declared stock splits executing in the next N days (default 7, max 28), sorted by split date ascending. Covers common stocks with an active listing; fund… - GETIPO Calendar
/api/company/ipo-calendar!Pro The market-wide IPO deal calendar. One entry per deal, moving through a lifecycle of filed, then upcoming (an expected pricing date is set), then priced… - GETEconomic model
/api/company/economic-model!Pro 🔒 Audit-grade by construction Every claim in this response is defensible in an IC meeting or audit. Most competing "AI fundamentals" APIs return…
Executives
- GETExecutive Officers
/api/executives/officers!Pro Returns the company's current executive officers (the CEO plus other executive officers active within roughly the last 18 months). Data source: SEC Form… - GETCompensation
/api/executives/compensation!Pro Returns historical CEO and officer compensation alongside Total Shareholder Return (TSR) comparison, extracted from the SEC-mandated… - GETGovernance Flags
/api/executives/governance!Pro Returns corporate governance flags related to executive compensation practices, extracted from DEF 14A proxy statements. These flags reveal important… - GETPerformance Measures
/api/executives/performance-measures!Pro Returns the performance measures that the company itself selected as most important for evaluating executive compensation, extracted from the…
Financials
- GETAs-reported financials
/api/financials/as-reported!Free !Starter !Pro Returns raw XBRL facts keyed by the concept the filer used, without mapping to curated line items. Includes both standard US-GAAP taxonomy… - GETIncome statement
/api/financials/income-statement!Free !Starter !Pro Returns normalized income statement data, revenue, cost of revenue, operating expenses, EBITDA, net income, EPS, and more. Facts are… - GETBalance sheet
/api/financials/balance-sheet!Free !Starter !Pro Returns normalized balance sheet data, total assets, current assets, total liabilities, stockholders' equity, cash, debt, and more. Facts… - GETCash flow statement
/api/financials/cash-flow-statement!Free !Starter !Pro Returns normalized cash flow data, operating, investing, and financing activities, free cash flow, capex, and more. Facts are mapped from… - GETFinancial growth rates
/api/financials/growth!Starter !Pro Returns year-over-year growth rates for key financial line items. Each value is expressed as a decimal (e.g. 0.15 = 15% growth, -0.08 = 8%… - GETSector-aware key metrics
/api/financials/key-metrics!Starter !Pro Returns financial metrics organized in three blocks: general (every company), sectorMetrics (varies by SIC-derived sector), and industryMetrics… - GETFinancial health scores
/api/financials/scores!Starter !Pro Returns two well-known financial health scores computed from the company's most recent annual filings: Piotroski F-Score (0-9): A composite… - GETFinancial health scores chart
/api/financials/chart/scores!Starter !Pro Returns chart-ready data for financial health scores over time: Piotroski F-Score (0-9) and Altman Z-Score. Annual periods only. Each period… - GETRevenue & profitability chart
/api/financials/chart/revenue-profitability!Free !Starter !Pro Returns chart-ready data for revenue, net income, and profitability margins over time. Periods are sorted ascending. Use series for… - GETCash flow chart
/api/financials/chart/cash-flow!Free !Starter !Pro Returns chart-ready data for operating cash flow, capital expenditure, and free cash flow over time. Periods are sorted ascending. - GETBalance sheet health chart
/api/financials/chart/balance-sheet-health!Free !Starter !Pro Returns chart-ready data for balance sheet composition (assets, liabilities, debt, cash) and health ratios (debt-to-equity, current ratio)… - GETPer-share metrics chart
/api/financials/chart/per-share!Free !Starter !Pro Returns chart-ready data for per-share financial metrics over time: EPS, revenue per share, book value per share, and free cash flow per…
Footnotes
- GETRevenue Segmentation
/api/footnotes/revenue-segmentation!Starter !Pro Returns revenue split by geography and product in a single response, period by period. Sourced from XBRL dimensional facts disclosed in 10-K /… - GETBusiness Segmentation
/api/footnotes/business-segmentation!Starter !Pro Returns per-business-segment financial metrics, revenue, operating income, gross profit, total assets, goodwill, D&A, capex, and net income,… - GETDebt Structure
/api/footnotes/debt-structure!Pro Returns a company's debt at the individual-borrowing level, straight from the debt footnote of 10-K / 10-Q filings: every note, bond, term loan, and… - GETCredit Facilities
/api/footnotes/credit-facilities!Pro Returns a company's credit facilities, revolvers, term-loan agreements, commercial-paper programs, one entry per facility, with total capacity, amount… - GETLeases
/api/footnotes/leases!Pro Returns the full ASC 842 lease footnote as one object per period: right-of-use asset, lease liability split (current / noncurrent / total), the… - GETStock Compensation
/api/footnotes/stock-compensation!Pro Returns plan-level share-based compensation from the equity footnote: the award roll-forward (granted / vested / forfeited / nonvested with… - GETConcentration Risk
/api/footnotes/concentration!Pro Returns concentration-risk disclosures as time series: named-counterparty dependence (e.g. "Apple is 50% of revenue, up from 37% three years ago"),… - GETRetirement Plans
/api/footnotes/retirement-plans!Pro Returns defined-benefit pension and other-postretirement (OPEB) disclosures from the benefits footnote: funded status, benefit obligation, cost… - GETRestructuring Programs
/api/footnotes/restructuring!Pro Returns per-program restructuring cost tracking from the restructuring footnote: what a named plan has cost to date, what it is expected to cost in… - GETAsset Composition
/api/footnotes/asset-composition!Pro Returns what the balance sheet's PP&E line is made of and where long-lived assets physically sit: classes: property, plant & equipment by class (land,… - GETShare Buybacks
/api/footnotes/buybacks!Pro Returns share-repurchase activity per period: cash spent on buybacks (from the cash-flow statement), shares and dollar value actually repurchased, the… - GETSubsidiary Financials
/api/footnotes/subsidiary-financials!Pro Returns income-statement and balance-sheet lines PER REGISTRANT SUBSIDIARY, exactly as the filer tagged them on the XBRL legal-entity axis. Utility… - GETFair Value Hierarchy
/api/footnotes/fair-value-hierarchy!Pro Returns the fair-value hierarchy tables from the footnotes: Level 1 (quoted prices), Level 2 (observable inputs), Level 3 (unobservable inputs), and… - GETREIT Property Schedule
/api/footnotes/reit-properties!Pro Returns SEC Schedule III (Real Estate and Accumulated Depreciation) as structured data: one entry per property with initial cost (land / buildings),… - GETBacklog / Remaining Performance Obligations
/api/footnotes/backlog!Pro Returns remaining performance obligations (RPO), the contracted revenue not yet recognized, the closest thing GAAP has to a bookings number, plus the… - GETSupplier Finance Programs
/api/footnotes/supplier-finance!Pro Returns supplier-finance (reverse-factoring) program disclosures, the FASB requirement effective 2023: the outstanding obligation under the program(s),… - GETWorkforce Cost
/api/footnotes/workforce-cost!Pro Returns what a company's workforce costs, assembled from the disclosures filers actually tag: the direct labor expense line where one exists (airlines,…
SEC Filings
- GETRecent S-1 offerings
/api/filings/recent-offerings!Pro Cross-company endpoint, no symbol required. Returns the most recent S-1/S-1A offering per company, filtered to filings within the specified number of… - GETSearch filings
/api/filings!Free !Starter !Pro Returns SEC filings for a company, optionally filtered by form type or 8-K event type. Results are paginated and restricted by your… - GETFiling by accession number
/api/filings/search-by-accession-number?accessionNumber=0000320193-23-000106!Free !Starter !Pro Returns a single SEC filing identified by its accession number. The filing must be within your subscription tier's historical data limit.… - GETLatest filings
/api/filings/latest!Starter !Pro Returns the most recent SEC filings across all companies, sorted by filing date descending. Limited to the last 30 days. Includes the company's… - GETFiling statistics
/api/filings/stats!Pro Returns aggregate filing activity statistics for a company, including total counts by form type, amendment rate, and XBRL coverage. Useful for… - GETFiling calendar
/api/filings/calendar!Pro Predicts upcoming periodic filing dates (10-K, 10-Q, DEF 14A) based on historical patterns from the last 5 years. Returns expected dates with confidence… - GETS-1 offering history
/api/filings/offering!Pro Returns S-1/S-1A offering filings for a company, ordered by filing date ascending. Tracks the evolution of IPO terms across amended registration… - GETFiling timeline
/api/filings/timeline!Pro Compressed research endpoint: returns the 10 most recent filings, predicted future filing dates with confidence levels, and the predicted next earnings… - GETList extracted items for a filing
/api/filings/item-list?accessionNumber=0000320193-25-000079!Pro > Preview: This endpoint is a preview of a planned feature for a future release. Item extraction is not yet enabled for the full filing universe, most… - GETExtract a single item from a filing
/api/filings/item?accessionNumber=0000320193-25-000079&item=1A!Pro > Preview: This endpoint is a preview of a planned feature for a future release. Item extraction is not yet enabled for the full filing universe, most…
Earnings
- GETEPS history
/api/earnings/eps-history!Free !Starter !Pro Returns earnings per share over time with basic and diluted EPS, net income, share counts, and year-over-year growth. Data is sourced from… - GETDividend history
/api/earnings/dividend-history!Free !Starter !Pro Returns dividend history for the given company symbol. Includes dividend per share (total dividends / shares outstanding), payout ratio… - GETEarnings snapshot
/api/earnings/snapshot!Starter !Pro One-call executive summary of a company's latest annual earnings. Includes core EPS, margins, returns, cash quality, year-over-year growth,… - GETEarnings trends
/api/earnings/trends!Pro Multi-year earnings analytics: compound annual growth rates (CAGR), margin trajectories with directional classification, margin volatility, and earnings… - GETEPS chart
/api/earnings/chart/eps!Free !Starter !Pro Chart-ready EPS and net income data over time. Use series for absolute values (EPS, Net Income) and rates for margin ratios (Net Margin).… - GETEarnings quality chart
/api/earnings/chart/quality!Free !Starter !Pro Chart-ready earnings quality data comparing net income against cash generation over time. Use series for absolute values (Net Income,… - GETEarnings calendar
/api/earnings/calendar?symbols=AAPL,MSFT,GOOGL!Pro Upcoming earnings dates and analyst consensus for up to 50 symbols in a single request. Each symbol maps to its next earnings date, expected report time,… - GETUpcoming earnings
/api/earnings/upcoming!Pro Companies reporting earnings in the next N days (default 7, max 28), sorted by earnings date ascending, with consensus EPS estimates and expected report… - GETUpcoming dividends
/api/earnings/upcoming-dividends!Pro Declared dividends with an ex-dividend date in the next N days (default 7, max 28), sorted by ex-date ascending. Covers common stocks with an active… - GETDividend date
/api/earnings/dividend-date!Starter !Pro Next declared dividend for a single stock: ex-dividend date, payment/record/announcement dates, dividend per share, and indicated annual… - GETEarnings date
/api/earnings/date!Starter !Pro Next earnings date for a single stock, with expected report time and consensus EPS estimate. Delisted companies (no active listing on any…
ETF/MF
- GETProfile
/api/fund/profile!Free !Starter !Pro Returns quarterly snapshots of a fund's financial profile, sourced from SEC N-PORT filings. Includes total assets, liabilities, net… - GETHoldings
/api/fund/holdings!Starter !Pro Returns the individual holdings of a fund from a single SEC N-PORT filing, with pagination. Defaults to the most recent filing; pass reportDate… - GETDaily Holdings
/api/fund/holdings/daily!Pro Returns a fund's daily holdings, sourced directly from the issuer's own website once a day, with pagination. This is far more current than the quarterly… - GETFunds with Daily Holdings
/api/fund/holdings/daily/supported-funds!Free !Starter !Pro Returns the flat list of fund ticker symbols for which daily website-published holdings are available via /api/fund/holdings/daily. The… - GETDaily Holdings History
/api/fund/holdings/daily/history!Pro How a fund's portfolio moved across the daily snapshots we retain, in one call instead of one call per day. Returns the dates in the window, the position… - GETFunds holding a symbol
/api/fund/reverse-lookup!Pro Returns a paginated list of ETFs and mutual funds that hold the specified symbol in their portfolio, based on the most recent N-PORT filings. Accepts any… - GETPortfolio composition
/api/fund/composition!Pro Returns a breakdown of the fund's portfolio by asset type, country, issuer type, and top 10 holdings from the most recent N-PORT filing. Useful for… - GETFlows
/api/fund/flows!Pro Returns quarterly fund flow data with monthly granularity, sales (inflows), redemptions (outflows), reinvestments, and monthly returns. Sourced from SEC… - GETPortfolio changes
/api/fund/changes!Pro Compares the two most recent N-PORT filings and returns holdings that were added, removed, or significantly reweighted (>0.05% portfolio weight change).… - GETPortfolio overlap
/api/fund/overlap?symbol1=VTI&symbol2=VOO!Pro Compares the holdings of two ETFs side by side. Returns overlap statistics (shared holdings count, exclusive counts) and per-holding detail showing… - GETHealth assessment
/api/fund/fund-health!Pro Comprehensive fund health assessment sourced from SEC N-CEN and N-PORT filings. Includes tracking quality metrics (for index funds), fair value hierarchy… - GETFee & cost analysis
/api/fund/fee-analysis!Pro Returns annual fee and cost data from SEC N-CEN filings, expense limitations, waivers, aggregate brokerage commissions, AUM, in-kind creation/redemption… - GETService provider history
/api/fund/service-providers!Pro Returns the full historical roster of service providers (custodians, administrators, auditors, transfer agents, brokers, authorized participants, etc.)… - GETFunds by adviser
/api/fund/by-adviser!Pro Returns the funds currently managed by an investment adviser (the fund issuer), based on the adviser roster in each fund's most recent SEC N-CEN filing.… - GETStructural analysis
/api/fund/structure!Pro Comprehensive structural analysis of a fund's portfolio over time. Includes sector allocation by quarter (SIC-based), industry breakdown, geographic… - GETFlows chart
/api/fund/chart/flows!Pro Chart-ready fund flow data over time. Use series for absolute values (Net Flows, Net Assets) and rates for the normalized flow-to-AUM ratio. Periods are… - GETSector allocation chart
/api/fund/chart/sectors!Pro Chart-ready sector allocation over time. Returns one series per top sector (by latest quarter weight), with portfolio weight values for each quarter.… - GETCountry allocation chart
/api/fund/chart/countries!Pro Chart-ready geographic allocation over time. Returns one series per top country (by latest quarter weight), with portfolio weight values for each… - GETIndustry group allocation chart
/api/fund/chart/industry-groups!Pro Chart-ready industry group allocation over time. Returns one series per top industry group (by latest quarter weight), with portfolio weight values for… - GETExposure model
/api/fund/exposure-model!Pro 🔒 Audit-grade by construction Every claim in this response is defensible in an IC meeting or audit. Most competing "AI fund classification" APIs return… - GETFee schedule
/api/fund/fees!Pro Returns paginated fee schedule data from SEC N-1A prospectus filings. Includes management fees, 12b-1 fees, expense ratios, fee waivers, sales charges,… - GETPerformance data
/api/fund/performance!Pro Returns paginated fund performance data from SEC N-CSR (annual/semi-annual shareholder report) filings. Includes annualized returns (1yr, 5yr, 10yr,… - GETPerformance chart
/api/fund/chart/performance!Pro Chart-ready fund performance data over time from SEC N-CSR filings. Use series for absolute values (Net Assets, Holdings Count) and rates for percentage…
Insider Transactions
- GETInsider transactions
/api/insider-transactions!Pro Returns insider transactions (Form 4/Form 5) for officers and directors. Transactions are deduplicated across co-owners and filings, each physical trade… - GETInsider transactions chart
/api/insider-transactions/chart!Pro Returns monthly aggregated insider transaction data for charting. Non-derivative transactions only. Transactions are deduplicated across co-owners, each… - GETInsider trading summary
/api/insider-transactions/summary!Pro Returns aggregated insider trading statistics for the last 3, 6, and 12 months. Only includes significant open-market trades (purchase and sale codes… - GETInsider roster
/api/insider-transactions/roster!Pro Returns all known insiders (officers and directors) for a company, with their most recent transaction date, total transaction count, and last reported… - GETTransactions by insider
/api/insider-transactions/by-insider?ownerCik=1214156!Pro Returns all transactions for a specific insider identified by their CIK. Useful for tracking a particular officer's or director's trading history.…
Ownership
- GETShare classes
/api/ownership/share-classes!Pro Returns share class information including outstanding and authorized shares, extracted from SEC filings. - GETBeneficial owners
/api/ownership/beneficial-owners!Pro Returns beneficial owners (5%+ shareholders) from SEC Schedule 13D/13G filings. Shows the most recent report per owner, ordered by ownership percentage.… - GETInstitutional holders
/api/ownership/institutional-holders!Pro Returns institutional holders from SEC 13F filings, aggregated by manager and security (cusip) for a given reporting quarter and paired with the prior… - GETInstitutional investor portfolio
/api/ownership/portfolio?cik=1067983!Pro Returns the full portfolio of an institutional investor (identified by CIK) from a 13F filing. This is the inverse of… - GETOwnership summary
/api/ownership/summary!Pro Returns an aggregate ownership breakdown for a stock: total institutional ownership percentage, holder count, top 10 holders, beneficial owner count, and… - GETInstitutional ownership history
/api/ownership/institutional-holders/history!Pro Returns quarterly time series of institutional ownership for a stock. Each entry represents one quarter's aggregated 13F data: total holder count,… - GETSearch institutional holders
/api/ownership/institutional-holders/search?query=blackrock!Pro Search for institutional investment managers by name. Returns matching manager names and CIKs. Use the returned managerCik with /api/ownership/portfolio… - GETBeneficial ownership history
/api/ownership/beneficial-owners/history!Pro Returns all Schedule 13D/13G filings for a stock, including historical entries. Unlike /api/ownership/beneficial-owners (which shows only the latest… - GETRecent ownership activity
/api/ownership/activity!Pro Combined feed of recent ownership changes for a stock: Insider transactions from the last 90 days (deduplicated, officers/directors only) Beneficial…
Congress Trades
- GETHouse trades by company
/api/congress/house/trades!Pro Stock trades disclosed by members of the U.S. House of Representatives in a given company, one row per disclosed transaction, newest transaction first.… - GETSenate trades by company
/api/congress/senate/trades!Pro Stock trades disclosed by U.S. Senators in a given company, one row per disclosed transaction, newest transaction first. Sourced from the periodic… - GETHouse trades by member
/api/congress/house/trades/by-member?bioguideId=P000197!Pro Every periodic transaction report filed by one House member, newest filing first, with the transactions each report disclosed. Identify the member by… - GETSenate trades by member
/api/congress/senate/trades/by-member?bioguideId=C001088!Pro Every periodic transaction report filed by one Senator, newest filing first, with the transactions each report disclosed. Identify the senator by… - GETHouse recent filings
/api/congress/house/trades/recent!Pro Market-wide feed of periodic transaction reports filed by House members, newest filing first, each with the transactions it disclosed. Ordered by filing… - GETSenate recent filings
/api/congress/senate/trades/recent!Pro Market-wide feed of periodic transaction reports filed by Senators, newest filing first, each with the transactions it disclosed. Ordered by filing date,… - GETHouse members
/api/congress/house/members!Pro Every House member (current or former) with at least one periodic transaction report on file, ordered by most recent filing. Use bioguideId with… - GETSenate members
/api/congress/senate/members!Pro Every Senator (current or former) with at least one periodic transaction report on file, ordered by most recent filing. Use bioguideId with…
Price
- GETQuotes (batched)
/api/price/quote?symbols=AAPL,MSFT,GOOGL!Free !Starter !Pro Data delayed 15 minutes. Latest OHLCV snapshot for one or more symbols in a single request. Pass symbols as a comma-separated list (up to… - GETHistorical Prices
/api/price/history!Free !Starter !Pro Data delayed 15 minutes. Historical price bars for one symbol at one resolution, returned as compact [ts_ms, value] tuples for efficient…
API details
- Base URL
https://api.stockfit.io/v1- Authentication
- A bearer token in the Authorization header
- Operations
- 125 operations on 125 pathsGET 125
1 marked deprecated - Main resources
- ETF/MF 23Footnotes 17Financials 12Earnings 11Company 10SEC Filings 10Ownership 9Symbol Lookup 9Congress Trades 8Insider Transactions 5
- Response formats
application/json- Description format
- OpenAPI 3.0.0, API version
1.0.0 - Links
- OpenAPI document
- Listed from
- Stockfit's published OpenAPI description
How to test the StockFit API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the StockFit API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Lookup by CIK” (GET /api/lookup/cik?cik=320193), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the StockFit API?
StockFit is structured intelligence from SEC filings: normalized financials, institutional ownership flows, ETF exposure analysis, filing event timelines, and… It is listed under Finance & banking and has 125 endpoints.
Who publishes the StockFit API?
It is listed from Stockfit's public API description (an OpenAPI document), not published by Stockfit on Swastik Codes. Anyone who controls stockfit.io can claim the profile by adding a DNS TXT record.
What is the base URL of the StockFit API?
Requests go to https://api.stockfit.io/v1. Endpoint paths are added to this base URL.
How do I authenticate with the StockFit API?
With A bearer token in the Authorization header.
How many endpoints does the StockFit API have?
125 operations on 125 paths (125 GET). The largest groups are ETF/MF, Footnotes, Financials, Earnings.
Is forking the StockFit API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.