{"api":"CSIMarket Data API","version":"v1","base_url":"https:\/\/api.csimarket.com\/api\/v1","description":"Institutional-grade financial analytics API covering 110 industries, 13 sectors, and 13,382+ companies. Includes benchmark metrics, factor scores, dispersion statistics, z-scores, and vs-industry comparisons across multiple classification systems.","authentication":{"type":"api_key","header":"X-API-Key","description":"License-based API key required for all \/api\/v1\/* endpoints. Metadata endpoints are public.","obtain":"https:\/\/csimarket.com\/pricing\/api","contact":"data.info@csimarket.com"},"period_types":{"TTM":"Trailing twelve months: rolling four-quarter aggregate","FY":"Fiscal year: annual reported figures","Q":"Quarterly: single quarter reported figures","D":"Daily: live point-in-time market snapshot (quant_factors dataset only)"},"time_models":{"description":"What kind of history each dataset serves. Each dataset in \/api\/datasets carries time_model, point_in_time (true only where a backtest can ask what was known at the time without look-ahead) and time_note.","as_known":"Values as they were knowable on a past date: each value has a knowledge time and every restatement is kept as a version (point_in_time_fundamentals).","restated_history":"One row per period holding today's figure; a restatement replaces the original.","reconstructed_history":"A history rebuilt recently from current data; survivorship-safe where stated, but not an as-known record.","snapshot":"Periodic cuts keyed by a reference date (13F quarter end).","event":"One row per dated event, with the date it became public.","current_state":"Today's state only; not a history.","datasets_url":"https:\/\/api.csimarket.com\/api\/datasets"},"value_scale":{"description":"All monetary values are reported in absolute dollars (raw USD). Values sourced from income statement, balance sheet, and cash flow tables are raw dollar figures. Per-share fields are dollars per share. Per-employee fields are dollars per employee.","currency_fields":"Raw USD: e.g. revenue = 1250000000 means $1.25 billion","per_share_fields":"Raw USD per share: e.g. eps_diluted = 6.43 means $6.43 per share","per_employee_fields":"Raw USD per employee: e.g. revenue_per_employee = 850000 means $850K per employee","percent_fields":"Decimal percentage: e.g. operating_margin = 12.45 means 12.45%","ratio_fields":"Dimensionless ratio: e.g. current_ratio = 1.85 means 1.85x","multiple_fields":"Valuation multiple: e.g. pe = 18.3 means 18.3x P\/E","score_fields":"0 to 100 scale","percentile_fields":"0 to 100 cross-sectional percentile rank: a RANK, not a probability","probability_fields":"0 to 1 scale: e.g. 0.12 means 12% probability","zscore_fields":"Standard deviations from mean","methodology_url":"https:\/\/api.csimarket.com\/api\/methodology"},"classification_systems":{"CSIMarket":"110 industries, 13 sectors: CSIMarket proprietary classification","SIC":"Standard Industrial Classification","NAICS":"North American Industry Classification System","ISIC":"International Standard Industrial Classification"},"datasets":[{"id":"industries","name":"Industry Fundamentals","description":"Industry-level fundamentals and analytics across 110 CSIMarket industries (also SIC\/NAICS): growth, profitability, valuation, financial strength, efficiency, and management effectiveness, with dispersion statistics and cross-industry percentile rankings. ~20 years of quarterly history for US-listed constituents.","frequency":"quarterly","entity_count":110,"period_types":["TTM","FY","Q"],"classifications":["CSIMarket","SIC","NAICS"],"key_field":"id","requires_license":true,"meta_public":true,"endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/industries\/{id}\/growth","endpoint":"growth","auth":true,"field_count":133,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/industries\/growth"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/industries\/{id}\/profitability","endpoint":"profitability","auth":true,"field_count":50,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/industries\/profitability"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/industries\/{id}\/valuation","endpoint":"valuation","auth":true,"field_count":41,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/industries\/valuation"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/industries\/{id}\/financial-strength","endpoint":"financial-strength","auth":true,"field_count":39,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/industries\/financial-strength"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/industries\/{id}\/efficiency","endpoint":"efficiency","auth":true,"field_count":23,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/industries\/efficiency"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/industries\/{id}\/management-effectiveness","endpoint":"management-effectiveness","auth":true,"field_count":35,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/industries\/management-effectiveness"}],"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/industries","schema_url":"https:\/\/api.csimarket.com\/api\/schema\/industries","dataset_url":"https:\/\/api.csimarket.com\/api\/datasets\/industries","sample_url":null},{"id":"sectors","name":"Sector Fundamentals","description":"Sector-level fundamentals across 13 CSIMarket sectors, mirroring the industry structure with cross-sector percentile rankings. ~20 years of quarterly history.","frequency":"quarterly","entity_count":13,"period_types":["TTM","FY","Q"],"classifications":["CSIMarket","SIC","NAICS"],"key_field":"id","requires_license":true,"meta_public":true,"endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/sectors\/{id}\/growth","endpoint":"growth","auth":true,"field_count":133,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/sectors\/growth"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/sectors\/{id}\/profitability","endpoint":"profitability","auth":true,"field_count":50,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/sectors\/profitability"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/sectors\/{id}\/valuation","endpoint":"valuation","auth":true,"field_count":41,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/sectors\/valuation"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/sectors\/{id}\/financial-strength","endpoint":"financial-strength","auth":true,"field_count":39,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/sectors\/financial-strength"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/sectors\/{id}\/efficiency","endpoint":"efficiency","auth":true,"field_count":23,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/sectors\/efficiency"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/sectors\/{id}\/management-effectiveness","endpoint":"management-effectiveness","auth":true,"field_count":35,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/sectors\/management-effectiveness"}],"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/sectors","schema_url":"https:\/\/api.csimarket.com\/api\/schema\/sectors","dataset_url":"https:\/\/api.csimarket.com\/api\/datasets\/sectors","sample_url":null},{"id":"company_fundamentals","name":"Company Fundamentals","description":"Company-level fundamentals for ~13,000 US-listed companies (identified by SEC CIK): growth, profitability, valuation, financial strength, efficiency, management effectiveness, per-share metrics, factor and forensic scores, cross-sectional z-scores, quant profiles, and signals.","frequency":"quarterly","entity_count":13382,"period_types":["TTM","FY","Q"],"classifications":["CSIMarket","SIC","NAICS"],"key_field":"cik","requires_license":true,"meta_public":true,"endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{cik}\/growth","endpoint":"growth","auth":true,"field_count":28,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/company_fundamentals\/growth"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{cik}\/profitability","endpoint":"profitability","auth":true,"field_count":33,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/company_fundamentals\/profitability"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{cik}\/valuation","endpoint":"valuation","auth":true,"field_count":55,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/company_fundamentals\/valuation"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{cik}\/financial-strength","endpoint":"financial-strength","auth":true,"field_count":38,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/company_fundamentals\/financial-strength"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{cik}\/efficiency","endpoint":"efficiency","auth":true,"field_count":21,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/company_fundamentals\/efficiency"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{cik}\/management-effectiveness","endpoint":"management-effectiveness","auth":true,"field_count":34,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/company_fundamentals\/management-effectiveness"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{cik}\/per-share","endpoint":"per-share","auth":true,"field_count":21,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/company_fundamentals\/per-share"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{cik}\/scores","endpoint":"scores","auth":true,"field_count":67,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/company_fundamentals\/scores"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{cik}\/signals","endpoint":"signals","auth":true,"field_count":25,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/company_fundamentals\/signals"}],"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/company_fundamentals","schema_url":"https:\/\/api.csimarket.com\/api\/schema\/company_fundamentals","dataset_url":"https:\/\/api.csimarket.com\/api\/datasets\/company_fundamentals","sample_url":null},{"id":"income_statements","name":"Income Statements","description":"Normalised income-statement history for ~13,000 US-listed companies, available as rendered display sections (by ticker or CIK) and as flat bulk rows for pipeline ingestion. ~20 years.","frequency":"quarterly","entity_count":13382,"period_types":["TTM","FY","Q"],"classifications":["CSIMarket","SIC","NAICS"],"key_field":"cik","requires_license":true,"meta_public":true,"endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/income-statement\/{identifier}\/statement","endpoint":"statement","auth":true,"field_count":71,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/income_statements\/statement"}],"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/income_statements","schema_url":"https:\/\/api.csimarket.com\/api\/schema\/income_statements","dataset_url":"https:\/\/api.csimarket.com\/api\/datasets\/income_statements","sample_url":null},{"id":"balance_sheets","name":"Balance Sheets","description":"Normalised balance-sheet history for ~13,000 US-listed companies, available as rendered display sections (by ticker or CIK) and as flat bulk rows for pipeline ingestion. ~20 years.","frequency":"quarterly","entity_count":13382,"period_types":["TTM","FY","Q"],"classifications":["CSIMarket","SIC","NAICS"],"key_field":"cik","requires_license":true,"meta_public":true,"endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/balance-sheet\/{identifier}\/statement","endpoint":"statement","auth":true,"field_count":92,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/balance_sheets\/statement"}],"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/balance_sheets","schema_url":"https:\/\/api.csimarket.com\/api\/schema\/balance_sheets","dataset_url":"https:\/\/api.csimarket.com\/api\/datasets\/balance_sheets","sample_url":null},{"id":"cash_flow_statements","name":"Cash Flow Statements","description":"Normalised cash-flow-statement history for ~13,000 US-listed companies, available as rendered display sections (by ticker or CIK) and as flat bulk rows for pipeline ingestion. ~20 years.","frequency":"quarterly","entity_count":13382,"period_types":["TTM","FY","Q"],"classifications":["CSIMarket","SIC","NAICS"],"key_field":"cik","requires_license":true,"meta_public":true,"endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/cash-flow\/{identifier}\/statement","endpoint":"statement","auth":true,"field_count":62,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/cash_flow_statements\/statement"}],"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/cash_flow_statements","schema_url":"https:\/\/api.csimarket.com\/api\/schema\/cash_flow_statements","dataset_url":"https:\/\/api.csimarket.com\/api\/datasets\/cash_flow_statements","sample_url":null},{"id":"quant_factors","name":"Quant Factors & Risk","description":"Quantitative factor exposures, risk scores, market structure, beta\/benchmark-relative metrics, index membership, ownership, liquidity, technicals, and regime labels for ~10,000 US-listed companies (by SEC CIK), derived from a daily market-structure model. Style factors (size\/value\/quality\/growth\/momentum\/low-vol\/liquidity), a composite factor score with cross-sectional percentile rank, factor z-scores, percentile-ranked risk scores (tail\/stress\/crash\/trend\/concentration), betas and alphas vs US-500\/Tech\/Nasdaq\/Small-2000 benchmarks, and institutional\/short-interest ownership. period_type states the FUNDAMENTALS BASIS behind the factor block: D = live daily snapshot, Q = completed quarter (single-quarter fundamentals), TTM = trailing twelve months, FY = fiscal year. Q\/TTM\/FY are a survivorship-safe history (2013 onward; delisted\/deregistered\/merged names are retained in the panel, so factor research is not survivorship-biased), rebuilt in 2026 from current data, so it is not an as-known (point-in-time) record: see time_note. For a given period all bases share the same as-of date, price and market cap; only the fundamentals-derived factors differ. FY rows key on a bare 4-digit fiscal year (tm=2025) and carry no trimester. Unreliable rows are served with the affected fields null and a per-row \"held\" reason (never a garbage value).","frequency":"daily + quarterly","entity_count":10020,"period_types":["D","Q","TTM","FY"],"classifications":["CSIMarket","SIC","NAICS"],"key_field":"cik","requires_license":true,"meta_public":true,"endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{ticker}\/quant-factors","endpoint":"quant-factors","auth":true,"field_count":91,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/quant_factors\/quant-factors"}],"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/quant_factors","schema_url":"https:\/\/api.csimarket.com\/api\/schema\/quant_factors","dataset_url":"https:\/\/api.csimarket.com\/api\/datasets\/quant_factors","sample_url":"https:\/\/api.csimarket.com\/api\/examples"},{"id":"insider_transactions","name":"Insider Transactions","description":"Insider transactions (officer, director and 10%-owner buys, sells, awards and dispositions) for US-listed companies: a per-company transaction stream, a net open-market buy\/sell summary with sentiment, and a per-insider view across all companies. Quarterly.","frequency":"quarterly","entity_count":20150,"period_types":["Q"],"classifications":["CSIMarket","SIC","NAICS"],"key_field":"cik","requires_license":true,"meta_public":true,"endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/insider-transactions","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/insider-summary","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/insiders\/{cik}","auth":true,"meta_url":null}],"meta_url":null,"schema_url":"https:\/\/api.csimarket.com\/api\/schema\/insider_transactions","dataset_url":"https:\/\/api.csimarket.com\/api\/datasets\/insider_transactions","sample_url":null},{"id":"institutional_ownership","name":"Institutional Ownership","description":"Institutional ownership for US-listed companies (identified by ticker or CIK): per-company holder lists and aggregate ownership, ownership concentration (Herfindahl index, Gini), ownership mix by manager type (passive\/active\/hedge fund\/mutual fund\/pension\/advisor), top holders, quarter-over-quarter position changes, and ownership history, plus the reverse manager view: a manager's full portfolio by manager CIK or name, and its AUM\/holdings history. Also a cross-sectional ownership screener. Quarterly; ~5 quarters of per-manager detail and growing.","frequency":"quarterly","entity_count":6206,"period_types":["Q"],"classifications":["CSIMarket","SIC","NAICS"],"key_field":"cik","requires_license":true,"meta_public":true,"endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/ownership","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/ownership\/history","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/ownership\/holders","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/ownership\/top-holders","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/ownership\/changes","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/ownership\/screener","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/holders\/{cik}","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/holders\/{name}\/holdings","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/holders\/{cik}\/history","auth":true,"meta_url":null}],"meta_url":null,"schema_url":"https:\/\/api.csimarket.com\/api\/schema\/institutional_ownership","dataset_url":"https:\/\/api.csimarket.com\/api\/datasets\/institutional_ownership","sample_url":null},{"id":"business_segments","name":"Business Segments & Geographic Exposure","description":"Reported business-segment and geographic revenue exposure for US filers, keyed to the income statement's own period model. Per member: revenue, operating income, and pct_of_total_revenue expressed against consolidated income-statement revenue (the canonical denominator, published on every response so every ratio is re-derivable). Members are NOT forced to sum to 100% and children are NOT forced to sum to their parent - partial disclosure is reported as disclosure_completeness, never as an error. Reconciliation is three independent measures: company revenue reconciliation, parent\/child reconciliation, and disclosure completeness. Geography is served as by_region and by_country, independent overlapping partitions that must never be summed across. Two tiers: source_tier=normalized (seg_fact, quant-grade, 90 companies as of 2026-08-13) and source_tier=legacy (compatibility fallback, tagged trust_tier=2, NOT quantitatively comparable and not eligible for the screener). Members carry a stable member_uid usable at \/api\/v1\/segments\/{member_uid}.","frequency":"quarterly","entity_count":10578,"period_types":["Q","FY"],"classifications":["CSIMarket","SIC","NAICS"],"key_field":"cik","requires_license":true,"meta_public":true,"endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/segments","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/geographic","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/exposure","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/segments\/history","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/geographic\/history","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/segments\/{member_uid}","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/segments\/{member_uid}\/history","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/segments\/screener","auth":true,"meta_url":null}],"meta_url":null,"schema_url":"https:\/\/api.csimarket.com\/api\/schema\/business_segments","dataset_url":"https:\/\/api.csimarket.com\/api\/datasets\/business_segments","sample_url":"https:\/\/api.csimarket.com\/api\/test\/companies\/AAPL\/segments"},{"id":"point_in_time_fundamentals","name":"Point-in-Time Fundamentals","description":"Statement fundamentals as they were actually knowable on a past date, rather than a single current value that overwrites what came before. Three retrieval modes that are never collapsed into one another: latest (current view), original (as first filed) and as_of (as known on a date you choose). Every restatement is kept as its own observation with its own vintage number, so a superseded figure stays retrievable instead of being destroyed by the correction, and every observation carries a knowledge time resolved from measured filing acceptance where available, with its source named. Durations are a hard filter, so a three-month figure is never returned where an annual one was requested, and values are raw as filed and labelled, never silently rescaled. Measured 2026-10-29: 50,307,195 observations across 17,020 companies, periods from 1991-05-31 to 2027-07-31, 3,286,802 superseded observations retained with vintages up to version 16, knowledge time on 49,832,401 observations (99.1%), and 12,233,686 observations labelled as derived rather than as-filed. The company count exceeds the current statements universe because delisted and deregistered filers are retained, which is what makes a survivorship-free study possible.","frequency":"per filing","entity_count":17020,"period_types":["Q","FY"],"classifications":["CSIMarket"],"key_field":"cik","requires_license":true,"meta_public":true,"endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/point_in_time_fundamentals\/{id}\/fundamentals","endpoint":"fundamentals","auth":true,"field_count":26,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/point_in_time_fundamentals\/fundamentals"}],"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/point_in_time_fundamentals","schema_url":"https:\/\/api.csimarket.com\/api\/schema\/point_in_time_fundamentals","dataset_url":"https:\/\/api.csimarket.com\/api\/datasets\/point_in_time_fundamentals","sample_url":null},{"id":"earnings_announcements","name":"Earnings Announcement Dates","description":"When companies announce they will release results, and when they actually did, read from their own SEC 8-K filings (Items 7.01\/8.01). Two directions from one table: forward-looking, the release date a company has announced in advance, with status (candidate until a real results filing lands within 10 days, then confirmed), a 0-100 confidence in the extracted date and a cadence_check against the company own reporting rhythm; and backward-looking, the announcement date for each past 10-K and 10-Q alongside the date the formal statement was filed, with the gap between them. Event-shaped: one row is one announcement, keyed on cik and ordered by target_date, so there is no TTM\/FY\/Q period vocabulary. Every row carries the source accession, the filing URL and the verbatim sentence the date was read from, so any date can be checked at source. Coverage is limited to issuers that pre-announce in an 8-K, which most do not: size it from \/api\/coverage before building on it.","frequency":"event","entity_count":47,"period_types":[],"classifications":["CSIMarket"],"key_field":"cik","requires_license":true,"meta_public":true,"endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/earnings_announcements\/{id}\/earnings-announcements","endpoint":"earnings-announcements","auth":true,"field_count":15,"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/earnings_announcements\/earnings-announcements"}],"meta_url":"https:\/\/api.csimarket.com\/api\/meta\/earnings_announcements","schema_url":"https:\/\/api.csimarket.com\/api\/schema\/earnings_announcements","dataset_url":"https:\/\/api.csimarket.com\/api\/datasets\/earnings_announcements","sample_url":null},{"id":"relationships","name":"Supply Chain & Commercial Relationship Graph","description":"Supply chain and commercial relationship graph - who a company buys from, sells to, partners with and competes against. Covers procurement and vendor exposure, customer and supplier concentration, counterparty dependency and multi-hop supply-chain risk. Disclosed relationships between companies: 120,721 active edges over 9,441 US-listed companies, across 12 dimensions (competitor, customer, supplier, partner, investment, jv, licensing, distribution, card_network, payment_network, card_processor, tech_vendor). Edge-shaped and NOT period-keyed: each edge carries effective_from \/ last_seen intervals, so point-in-time is approximate via ?as_of, never a vintage replay. Every edge names its provenance in a top-level tier (REPORTED = behind it is the company's own announcement or news; GENERAL_KNOWLEDGE = commonly known, not traced to one document; INFERRED = model or legacy), and ?tier returns ALL provenances by default, narrowing to reported, news, established_relationships or general_knowledge. The underlying evidence records name their source category (company_announcements, news, established_relationships, general_knowledge) with excerpts, years and the source reference. Supplier edges additionally carry a roles array naming the function (one of 11: foundry, packaging_testing, contract_manufacturer, equipment, raw_material, component, logistics, energy, technology_software, infrastructure, outsourced_service). Counterparties are public (has CIK), foreign (ticker, no CIK) or private (named only), and unresolved counterparties are TERMINAL in graph traversal and counted in coverage, never silently dropped. Derived datasets on top: supplier dependency, customer concentration, market share against the disclosed competitor set, multi-hop neighbourhood, connection paths and indirect exposure. Each relationship has a stable rel_uid that survives graph rebuilds. The whole graph is also available in bulk as an edge list: \/api\/v1\/relationships (cursor-paged, up to 1,000 rows a page) and \/api\/v1\/relationships\/export (one CSV), both needing bulk.read and relationships.read. Not available as an OData entity set - use the REST endpoints or MCP.","frequency":"continuous (filing and news driven)","entity_count":9441,"period_types":[],"classifications":["CSIMarket"],"key_field":"rel_uid","requires_license":true,"meta_public":false,"endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/relationships","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/relationships\/history","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/competitors","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/customers","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/suppliers","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/customer-concentration","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/supplier-dependency","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/relationship-risk","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/supply-chain\/geography","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/graph\/neighborhood","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/graph\/exposure","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/graph\/paths","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships\/compare","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships\/export","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships\/{rel_uid}","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships\/{rel_uid}\/evidence","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships\/{rel_uid}\/history","auth":true,"meta_url":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships\/{rel_uid}\/values","auth":true,"meta_url":null}],"meta_url":null,"schema_url":"https:\/\/api.csimarket.com\/api\/schema\/relationships","dataset_url":"https:\/\/api.csimarket.com\/api\/datasets\/relationships","sample_url":"https:\/\/api.csimarket.com\/api\/test\/companies\/AAPL\/relationships"}],"market_structure_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{ticker}\/market-structure\/technical","description":"Daily technical snapshot: price, DMA signals, momentum, volatility\/risk, index membership. No API key required.","auth":false,"rate_limit":"120\/min per IP","period_type":"D","scope":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{ticker}\/market-structure\/ttm","description":"Latest quarterly snapshot: liquidity, turnover, float, ownership, volatility. No API key required.","auth":false,"rate_limit":"60\/min per IP","period_type":"Q","scope":null},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{ticker}\/market-structure\/advanced","description":"Full quarterly commercial panel: factor scores, z-scores, alpha, beta matrix, ownership, liquidity depth, drawdown, risk scores, index analytics.","auth":true,"scope":"market.read","period_type":"Q"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{ticker}\/market-structure\/history","description":"Point-in-time history. ?period_type=Q|D (default Q). Public licenses: last 4 periods. market.read: full history (up to 100 periods).","auth":true,"scope":"any key; market.read for full history","params":["period_type","from","to"]}],"stock_price_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/stocks\/{identifier}\/price","description":"Quote for the latest or any historical trading day (?date=). Fully descriptive English metric names: OHLC, previous_close, change, change_percent, return_1_day..return_252_days, volume, dollar_volume, typical_price, average_true_range_14_days. time_basis=snapshot.","auth":true,"scope":"stocks.read","params":["date"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/stocks\/{identifier}\/history","description":"Daily OHLCV series, newest first. ?from\/?to date range, ?limit up to 1000 rows.","auth":true,"scope":"stocks.read","params":["from","to","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/market\/performance","description":"Total-market cap-weighted trading-day returns, breadth, constituent count, total\/average market cap - reproducible for any trading day from 2013-04-01 (?date=).","auth":true,"scope":"market.read","params":["date"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/market\/movers","description":"Top gainers \/ losers \/ most active for any trading day. ?window=1_day..252_days, filters ?sector\/?industry\/?index.","auth":true,"scope":"market.read","params":["date","window","sector","industry","index","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/sectors\/performance","description":"Cap-weighted returns and breadth per sector, rankable (?sort\/?order), any trading day.","auth":true,"scope":"market.read","params":["date","sort","order"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/industries\/performance","description":"Cap-weighted returns and breadth per industry, rankable (?sort\/?order\/?limit), any trading day.","auth":true,"scope":"market.read","params":["date","sort","order","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/indices\/{index}","description":"Index composite - six indices: usa500 (GSPC), usatech100 (NDX), usasmallcap (RUT), usa30 (DJI), usatech (IXIC Nasdaq Composite), usavolatility (VIX). Benchmark quote (historical OK) + current-session constituent aggregates, breadth, top contributors for the three membership-backed indices; usa30\/usatech\/usavolatility are benchmark-only. No point-in-time membership history - historical constituents are never backfilled.","auth":true,"scope":"market.read","params":["date"]}],"segment_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/segments","description":"Business segment revenue and operating income, as reported. dim_type is the top-level discriminator (business\/geographic\/product\/other). Reportable vs disaggregation level, % of consolidated revenue, currency, reconciliation status (reconciled\/short\/over\/na) and filing provenance. Total is the reported income figure, never a sum of segments.","auth":true,"scope":"segments.read","params":["dim","granularity","level","restated","as_of","limit","offset"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/geographic","description":"Geographic revenue exposure. by_region and by_country are independent, overlapping partitions - each approximates the consolidated total on its own and must never be summed across, since a region contains its countries.","auth":true,"scope":"segments.read","params":["geo_view","granularity","as_of"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/exposure","description":"Segment and geographic exposure combined in one call.","auth":true,"scope":"segments.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/segments\/history","description":"Segment time series, pinned to one granularity (quarterly or annual) so a series never mixes 3-month and 12-month points.","auth":true,"scope":"segments.history.read","params":["dim","granularity","as_of"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/geographic\/history","description":"Geographic exposure over time.","auth":true,"scope":"segments.history.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/segments\/{member_uid}","description":"Single segment member by stable id (member_uid, constant across rebuilds - keyed on the XBRL member, so business and geographic members can never collide).","auth":true,"scope":"segments.detail.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/segments\/{member_uid}\/history","description":"One segment member time series.","auth":true,"scope":"segments.history.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/segments\/screener","description":"Cross-sectional exposure screen - filter companies by geography or segment share of revenue. POST.","auth":true,"scope":"segments.screener.read","params":["dim","region_code","min_pct_of_total","reconciled_only","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/test\/companies\/AAPL\/segments","description":"Free sample - AAPL consolidated + up to 5 reportable business segments. No auth. Other tickers 403.","auth":false}],"relationship_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/relationships","description":"NEW: company relationship graph across 12 dimensions (competitor\/customer\/supplier\/partner\/investment\/jv\/licensing\/distribution\/card_network\/payment_network\/card_processor\/tech_vendor), and ?tier now DEFAULTS TO ALL provenances rather than filings-only. Narrow with ?tier=reported (the company's own announcements), news, established_relationships or general_knowledge. Each edge labels its tier, confidence, point-in-time dates, counterparty entity_kind (public\/foreign\/private), evidence availability. Competitors are materiality-ranked.","auth":true,"scope":"relationships.read","new":true,"added":"2026-10-12","params":["type","tier","direction","min_confidence","limit","offset"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/competitors","description":"Competitors: the peer group a company names in its own filings, materiality-ranked. Use for peer selection and market share instead of an industry code.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/customers","description":"Customers \/ corporate clients: the companies a company SELLS TO. Who buys from it, which clients it names in its filings, and the buyers whose own filings name it as a supplier. Pair with customer-concentration for revenue dependency on major clients.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/suppliers","description":"Suppliers \/ vendors: the companies a company BUYS FROM. Procurement and sourcing relationships, each with the supplier function (foundry, contract manufacturer, raw material and 8 more). Pair with supplier-dependency for single-source risk.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/partners","description":"Partners and strategic alliances: collaboration and co-development relationships that are neither purchase nor sale.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/investments","description":"Investments and M&A stakes: equity positions and acquisitions a company discloses in other companies.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/jv","description":"Joint ventures: jointly owned operating entities, symmetric by nature so both parties are returned.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/licensing","description":"Licensing: technology, patent and brand licensing relationships, in both directions (licensor and licensee).","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/distribution","description":"Distribution and reseller relationships: channel partners, distributors and the route a product takes to market.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships\/{rel_uid}","description":"Single relationship by stable id (rel_uid, constant across rebuilds).","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships\/{rel_uid}\/evidence","description":"Provenance\/evidence behind a relationship (filing \/ news \/ legacy). Professional+.","auth":true,"scope":"relationships.evidence.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships\/{rel_uid}\/values","description":"Disclosed monetary values attached to one relationship (revenue attributable to a named customer, purchase commitments), each with its filing provenance. Enterprise.","auth":true,"scope":"relationships.value.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships\/{rel_uid}\/history","description":"Point-in-time history of one relationship: when it was first disclosed, re-confirmed, and last seen.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships\/compare","description":"Compare the relationship graphs of several companies in one call: shared customers, shared suppliers, overlapping competitor sets. Takes ?companies=NVDA,AMD (comma-separated, 2-5).","auth":true,"scope":"relationships.read","params":["companies","type","tier"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships","description":"The whole relationship graph as an edge list (all companies), up to 1,000 rows a page with a cursor. Current state, not point-in-time. Enterprise: needs bulk.read and relationships.read.","auth":true,"scope":"bulk.read + relationships.read","params":["type","tier","min_confidence","last_seen_since","per_page","cursor"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/relationships\/export","description":"The whole relationship graph as one CSV file (same rows and filters as \/relationships).","auth":true,"scope":"bulk.read + relationships.read","params":["type","tier","min_confidence","last_seen_since"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/relationships\/history","description":"Relationship graph as it stood at any past date: edges added, re-confirmed and dropped over time.","auth":true,"scope":"relationships.read","params":["type","as_of","from","to"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/supply-chain\/geography","description":"Where a company's disclosed suppliers and customers are located, resolved to country and region.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/customer-concentration","description":"Revenue concentration across disclosed named customers, built only from disclosed values. Enterprise.","auth":true,"scope":"relationships.value.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/supplier-dependency","description":"Dependency on disclosed suppliers, including single-source and sole-supplier language found in filings.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/relationship-risk","description":"Relationship-derived risk view: concentration, single-source exposure and counterparty mix, as datasets rather than a score.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/market-share","description":"Market share against the DISCLOSED competitor set: per-member revenue, share of the set, rank and coverage. The denominator is the combined revenue of the companies the filings actually name as competitors, never an estimate of total addressable market, and coverage is returned with the number so a partial set is visible.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/market-share\/history","description":"The same market-share measure as an annual TTM series, so a gain or loss of position reads as a trend rather than a single reading. Same disclosed-set denominator and the same coverage reporting.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/test\/companies\/AAPL\/relationships","description":"Free sample: AAPL counts + 5 records. No auth. Other tickers 403.","auth":false}],"graph_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/graph\/neighborhood","description":"The graph around one company out to N hops: counterparties, their counterparties, each edge carrying its own trust tier and confidence. All 12 dimensions are traversable and ?tier defaults to all provenances.","auth":true,"scope":"relationships.read","params":["hops","types","tier","min_confidence","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/graph\/paths","description":"Shortest disclosed paths between two companies: how an exposure actually connects, edge by edge.","auth":true,"scope":"relationships.read","params":["from","to","max_depth","type"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/graph\/exposure","description":"Indirect exposure through the graph: which counterparties a company reaches at each hop, and through whom.","auth":true,"scope":"relationships.read","params":["depth","type"]}],"news_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/news","description":"Cross-market news feed, normalised and de-duplicated: one story per event with its sources attached, not one row per wire copy.","auth":true,"scope":"news.read","params":["from","to","event_type","limit","offset"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/news\/events","description":"Classified corporate events extracted from news and filings (guidance, contract wins, management change, M&A, capacity, legal).","auth":true,"scope":"news.read","params":["event_type","identifier","from","to","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/news\/articles\/{id}","description":"One article by id, with source, publisher, timestamps and the companies it resolves to.","auth":true,"scope":"news.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/news\/stories\/{cluster_id}","description":"One story cluster: every article covering the same event, in publication order.","auth":true,"scope":"news.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/news","description":"News and events for one company, resolved to its CIK rather than matched on name.","auth":true,"scope":"news.read","params":["from","to","event_type","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/industries\/{id}\/news","description":"News rolled up to a CSIMarket industry.","auth":true,"scope":"news.read","params":["from","to","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/sectors\/{id}\/news","description":"News rolled up to a CSIMarket sector.","auth":true,"scope":"news.read","params":["from","to","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/market\/news","description":"Market-wide news stream across the whole covered universe.","auth":true,"scope":"news.read","params":["from","to","limit"]}],"point_in_time_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/fundamentals","description":"Raw point-in-time statement values with the vintage they were filed in. mode=latest|as_of|original selects the replay semantics (as_of requires the as_of param); restatements kept as separate versions rather than overwriting history. Values are raw filing units.","auth":true,"scope":"fundamentals.read","params":["metric","duration","mode","as_of","period_end","statement"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/earnings-dates","description":"When each reported period was actually announced, so a point-in-time query can align to the announcement rather than the period end.","auth":true,"scope":"fundamentals.read","params":["form","period_end","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/earnings-calendar","description":"When a company has said it will release its next results, from its own advance 8-K announcement. Current best guess per period plus next_earnings_date; as_of returns what was known on a past date, with each row's status as it stood then. Rows carry status, confidence and the source 8-K.","auth":true,"scope":"fundamentals.read","params":["as_of"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/market\/earnings-calendar","description":"Every company with an announced earnings release date in a date range (default next 30 days, max 92). Same row shape as the per-company calendar.","auth":true,"scope":"fundamentals.read","params":["start","end","limit"]}],"company_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/search","description":"Resolve a name, ticker or CIK to a company. Handles dual-class tickers and recycled symbols.","auth":true,"scope":"companies.read","params":["q","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/discover","description":"Semantic company discovery from a plain-language description of what a company does.","auth":true,"scope":"companies.read","params":["q","industry","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/similar","description":"Same-industry peers ranked by business-description similarity. INFERRED, not a disclosed relationship.","auth":true,"scope":"companies.read","params":["limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/overview-report","description":"NEW: AI-ready composite company overview in one call. Currently identity, live market and quant snapshot, and TTM headline fundamentals, with section coverage expanding as later phases ship, so read the returned section keys rather than assuming a fixed set. Every section carries a typed status: one your licence does not cover comes back labelled not_licensed instead of failing the request, and a figure with a known data-quality issue is flagged rather than presented as clean.","auth":true,"scope":"companies.read","new":true,"added":"2026-09-30","params":["sections","detail"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/research-dossier","description":"One call that composes the blocks a research note starts from: overview, ratios, quant, ownership, relationships, segments and recent events.","auth":true,"scope":"companies.read","params":["period_type","sections"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/zscores","description":"Cross-sectional z-scores for a company against its industry, sector and the total market.","auth":true,"scope":"companies.read","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/quant-profile","description":"Factor profile in one response: exposures, percentile ranks and the composite scores.","auth":true,"scope":"companies.read","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{ticker}\/dashboard","description":"All six fundamental dimensions for one company in one response.","auth":true,"scope":"companies.read","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{ticker}\/income-statements","description":"Income statement history for one company, quarterly or annual.","auth":true,"scope":"statements.read","params":["period_type","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{ticker}\/balance-sheets","description":"Balance sheet history for one company.","auth":true,"scope":"statements.read","params":["period_type","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{ticker}\/cash-flow-statements","description":"Cash flow statement history for one company.","auth":true,"scope":"statements.read","params":["period_type","limit"]}],"industry_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/industries\/search","description":"Resolve an industry name or colloquial term to a CSIMarket industry id.","auth":true,"scope":"industries.read","params":["q","limit"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/industries\/{id}\/dashboard","description":"All six benchmark dimensions for one industry in one response.","auth":true,"scope":"industries.read","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/sectors\/{id}\/dashboard","description":"All six benchmark dimensions for one sector in one response.","auth":true,"scope":"industries.read","params":["period_type"]}],"screening_bulk_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/quant-factors\/screener","description":"Cross-sectional factor screen over the quant panel.","auth":true,"scope":"quant.read","params":["filters","sort","limit","offset"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/income-statements","description":"Bulk income statements across companies for a period. Enterprise.","auth":true,"scope":"bulk.read","params":["period_type","fiscal_year","limit","offset"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/income-statements\/export","description":"Asynchronous bulk export of income statements. Enterprise.","auth":true,"scope":"bulk.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/balance-sheets","description":"Bulk balance sheets across companies. Enterprise.","auth":true,"scope":"bulk.read","params":["period_type","fiscal_year","limit","offset"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/balance-sheets\/export","description":"Asynchronous bulk export of balance sheets. Enterprise.","auth":true,"scope":"bulk.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/cash-flow-statements","description":"Bulk cash flow statements across companies. Enterprise.","auth":true,"scope":"bulk.read","params":["period_type","fiscal_year","limit","offset"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/cash-flow-statements\/export","description":"Asynchronous bulk export of cash flow statements. Enterprise.","auth":true,"scope":"bulk.read"}],"market_aggregate_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/market","description":"Total-market summary: headline KPIs, scores, company count, market cap.","auth":false,"rate_limit":"60\/min per IP","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/market\/growth","description":"Total-market growth analytics: revenue\/income\/FCF YoY\/seq, CAGRs, breadth diffusion, consistency scores.","auth":false,"rate_limit":"60\/min per IP","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/market\/profitability","description":"Total-market profitability: gross\/operating\/net\/EBITDA margins and their dispersion statistics.","auth":false,"rate_limit":"60\/min per IP","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/market\/valuation","description":"Total-market valuation: P\/E, EV\/EBITDA, P\/S, P\/B, earnings yield, FCF yield, total market cap.","auth":false,"rate_limit":"60\/min per IP","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/market\/financial-strength","description":"Total-market financial strength: liquidity ratios, leverage, interest coverage, Altman Z-score.","auth":false,"rate_limit":"60\/min per IP","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/market\/efficiency","description":"Total-market efficiency: asset turnover, CCC, DSO, DIO, DPO, revenue per employee.","auth":false,"rate_limit":"60\/min per IP","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/market\/management-effectiveness","description":"Total-market management effectiveness: ROE, ROA, ROIC, DuPont decomposition, FCF conversion.","auth":false,"rate_limit":"60\/min per IP","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/market\/dashboard","description":"Full total-market dashboard: all six dimension tabs in one response (growth, profitability, efficiency, financial_strength, valuation, management_effectiveness, scores).","auth":false,"rate_limit":"30\/min per IP","params":["period_type"]}],"market_v1_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/market\/growth","description":"Total-market growth analytics, licensed surface.","auth":true,"scope":"growth.read","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/market\/profitability","description":"Total-market profitability, licensed surface.","auth":true,"scope":"profitability.read","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/market\/valuation","description":"Total-market valuation, licensed surface.","auth":true,"scope":"valuation.read","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/market\/financial-strength","description":"Total-market financial strength, licensed surface.","auth":true,"scope":"financial_strength.read","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/market\/efficiency","description":"Total-market efficiency, licensed surface.","auth":true,"scope":"efficiency.read","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/market\/management-effectiveness","description":"Total-market management effectiveness, licensed surface.","auth":true,"scope":"management_effectiveness.read","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/market\/dashboard","description":"Total-market dashboard, licensed surface.","auth":true,"scope":"industries.read","params":["period_type"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/market\/regime","description":"Market regime read: breadth, dispersion and leadership state on the resolved date.","auth":true,"scope":"market.read","params":["date"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/sectors\/rotation","description":"Sector rotation: relative leadership shifts across return windows.","auth":true,"scope":"market.read","params":["date","window"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/industries\/rotation","description":"Industry rotation: relative leadership shifts across return windows.","auth":true,"scope":"market.read","params":["date","window"]}],"meta_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/openapi.json","description":"OpenAPI 3 specification for the whole v1 surface: every path, parameter enum, security scheme and response. The authoritative machine-readable contract - generate a client from this rather than scraping these descriptions.","auth":false,"variants":{"https:\/\/api.csimarket.com\/api\/openapi-adx.json":"Azure Data Exchange profile (full surface)","https:\/\/api.csimarket.com\/api\/openapi-adx-quant.json":"ADX profile, quant factors only","https:\/\/api.csimarket.com\/api\/openapi-adx-free.json":"ADX profile, free evaluation tier only"}},{"url":"https:\/\/api.csimarket.com\/api\/docs","description":"Interactive Swagger UI over the same specification. Click Authorize and paste an API key before using Try it out, otherwise requests are sent unauthenticated and answer 401.","auth":false},{"url":"https:\/\/api.csimarket.com\/api\/discovery","description":"This document: full API surface index","auth":false},{"url":"https:\/\/api.csimarket.com\/api\/datasets","description":"Dataset catalog with coverage and period type information","auth":false},{"url":"https:\/\/api.csimarket.com\/api\/datasets\/{id}","description":"Single dataset detail with full field dictionary","auth":false},{"url":"https:\/\/api.csimarket.com\/api\/meta\/{dataset}\/{endpoint}","description":"Field definitions for a specific endpoint: name, type, unit, description, formula, category","auth":false,"example":"https:\/\/api.csimarket.com\/api\/meta\/industries\/growth"},{"url":"https:\/\/api.csimarket.com\/api\/fields","description":"Flat searchable field dictionary across all datasets. Supports ?dataset= and ?category= filters","auth":false,"example":"https:\/\/api.csimarket.com\/api\/fields?dataset=industries&category=Growth"},{"url":"https:\/\/api.csimarket.com\/api\/schema\/{dataset}","description":"Full schema for a dataset including query parameters and response structure","auth":false},{"url":"https:\/\/api.csimarket.com\/api\/coverage","description":"Live entity counts and date ranges from the database","auth":false},{"url":"https:\/\/api.csimarket.com\/api\/methodology","description":"Methodology documentation: TTM calculation, z-score construction, percentile ranking, classification mapping","auth":false},{"url":"https:\/\/api.csimarket.com\/api\/changelog","description":"API changelog: schema changes, new endpoints, deprecations","auth":false},{"url":"https:\/\/api.csimarket.com\/api\/status","description":"API health and per-tier rate limits","auth":false},{"url":"https:\/\/api.csimarket.com\/api\/examples","description":"Live sample: quant_factors dataset: AAPL (D + 2 Q) and a cross-sectional screener slice. No auth required.","auth":false,"example":"https:\/\/api.csimarket.com\/api\/examples"},{"url":"https:\/\/api.csimarket.com\/api\/test\/companies\/AAPL\/quant-factors","description":"Free quant-factors sample: the full 92-field factor & risk panel for AAPL (AAPL-only; any other ticker returns 403). Append ?period_type=Q for the point-in-time quarterly history (survivorship-safe, 2013-present). No auth required.","auth":false,"example":"https:\/\/api.csimarket.com\/api\/test\/companies\/AAPL\/quant-factors"}],"export_endpoints":[{"url":"https:\/\/api.csimarket.com\/api\/v1\/exports","method":"POST","description":"Submit an asynchronous export job for a whole dataset. Body: dataset (required), plus optional filters and fields. Returns a job_id to poll. Requires export access (Institutional or Enterprise); other licences receive 403. Row ceiling comes from the licence plan.","auth":true,"params":["dataset","filters","fields","format"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/exports","method":"GET","description":"Your 20 most recent export jobs, newest first. Scoped to the calling licence.","auth":true},{"url":"https:\/\/api.csimarket.com\/api\/v1\/exports\/{job_id}","method":"GET","description":"Export job status: queued, running, completed, failed or expired, with row count and file size once finished. Poll this after submitting.","auth":true},{"url":"https:\/\/api.csimarket.com\/api\/v1\/exports\/{job_id}\/download","method":"GET","description":"Download a completed export file. Answers 409 while the job is still running, so poll the status endpoint until it reports completed.","auth":true},{"url":"https:\/\/api.csimarket.com\/api\/v1\/exports\/{job_id}","method":"DELETE","description":"Cancel a running job, or delete a completed file immediately rather than waiting for expiry.","auth":true},{"url":"https:\/\/api.csimarket.com\/api\/v1\/license\/status","description":"Your licence as the API sees it: plan, scopes granted, and limits.","auth":true,"scope":"license.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/license\/usage","description":"Your own request volume against the rate limit, per minute, with recent history. Use this to pace a client instead of discovering the limit by hitting 429.","auth":true,"scope":"license.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/license\/audit","description":"Audit trail for your own licence: recent access events and security-relevant changes.","auth":true,"scope":"license.read"}],"odata_service":{"description":"OData 4.0 service. Two tiers: free evaluation (test, 9 entity sets, industry 201 sample) and licensed (v1, 41 entity sets, full surface). V1 EDMX is auto-synced from FieldRegistry field definitions.","tiers":[{"tier":"test","auth":false,"service_root":"https:\/\/api.csimarket.com\/api\/odata\/test\/","metadata":"https:\/\/api.csimarket.com\/api\/odata\/test\/$metadata","description":"Free: no API key. 9 entity sets. Industries_List = full taxonomy. Analytics restricted to industry 201 (Aerospace & Defense), mirroring \/api\/test\/industries\/201\/*.","excel_url":"https:\/\/api.csimarket.com\/api\/odata\/test\/","entity_sets":["Industries_List","Industries_Overview","Industries_Growth","Industries_Profitability","Industries_Valuation","Industries_FinancialStrength","Industries_Efficiency","Industries_ManagementEffectiveness","Industries_Dashboard"]},{"tier":"v1","auth":true,"header":"X-API-Key","service_root":"https:\/\/api.csimarket.com\/api\/odata\/v1\/","metadata":"https:\/\/api.csimarket.com\/api\/odata\/v1\/$metadata","description":"Licensed: requires X-API-Key. 41 entity sets mirroring the full \/api\/v1\/ surface. EDMX auto-synced with FieldRegistry.","excel_url":"https:\/\/api.csimarket.com\/api\/odata\/v1\/","excel_auth":"In Excel \"Advanced\" options \u2192 Custom headers: X-API-Key: <your-key>","entity_sets":["Industries_List","Industries_Overview","Industries_Growth","Industries_Profitability","Industries_Valuation","Industries_FinancialStrength","Industries_Efficiency","Industries_ManagementEffectiveness","Industries_Dashboard","Sectors_List","Sectors_Overview","Sectors_Growth","Sectors_Profitability","Sectors_Valuation","Sectors_FinancialStrength","Sectors_Efficiency","Sectors_ManagementEffectiveness","Sectors_Dashboard","Companies_List","Companies_Overview","Companies_Growth","Companies_Profitability","Companies_Valuation","Companies_FinancialStrength","Companies_Efficiency","Companies_ManagementEffectiveness","Companies_PerShare","Companies_Scores","Companies_Zscores","Companies_QuantProfile","Companies_Signals","Companies_Dashboard","Companies_MarketStructure_Technical","Companies_MarketStructure_TTM","Companies_MarketStructure_Advanced","Companies_MarketStructure_History","Companies_IncomeStatements","Companies_BalanceSheets","Companies_CashFlow","Companies_QuantFactors","QuantFactors_Screener"],"company_filter_note":"Company analytics (Companies_Growth etc.) return cross-sectional top-N. Add $filter=ticker eq 'AAPL' to scope to one company. Market-structure, quant-factors, and statement entity sets redirect to REST endpoints."}],"query_options":["$filter","$select","$top (max 500)","$orderby"],"decimal_encoding":"All numeric values typed Edm.Double (IEEE 754 double-precision). Edm.Double is exempt from IEEE754Compatible negotiation, values are bare JSON numbers, no quoting."},"response_formats":["json","csv (?format=csv on single-analytic endpoints)","odata (see odata_service above)"],"common_query_parameters":{"period_type":{"description":"Period series to return","values":["TTM","FY","Q"],"default":"TTM"},"classification_type":{"description":"Classification system for industry\/sector resolution","values":["CSIMarket","SIC","NAICS"],"default":"CSIMarket"},"limit":{"description":"Number of historical periods to return","default":"TTM=4, FY=5, Q=8"}},"rate_limits":{"description":"Rate limits vary by license tier. See \/api\/status for current limits.","details_url":"https:\/\/api.csimarket.com\/api\/status"},"support":{"email":"data.info@csimarket.com","documentation":"https:\/\/api.csimarket.com\/api\/methodology","interactive":"https:\/\/api.csimarket.com\/api\/docs","pricing":"https:\/\/csimarket.com\/pricing\/api","sample_data":"https:\/\/api.csimarket.com\/api\/examples","status":"https:\/\/api.csimarket.com\/api\/status","changelog":"https:\/\/api.csimarket.com\/api\/changelog"}}