{"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\/help\/licensing\/","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)"},"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","GICS":"Global Industry Classification Standard"},"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":65,"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":78,"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":58,"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 point-in-time, survivorship-safe history (2013 onward; delisted\/deregistered\/merged names are retained in the panel, so factor research is not survivorship-biased). 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":"https:\/\/api.csimarket.com\/api\/meta\/insider_transactions","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":"https:\/\/api.csimarket.com\/api\/meta\/institutional_ownership","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":"https:\/\/api.csimarket.com\/api\/meta\/business_segments","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"}],"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"]}],"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":"Company relationship graph across 8 dimensions (competitor\/customer\/supplier\/partner\/investment\/jv\/licensing\/distribution). Each edge labels REPORTED vs INFERRED trust tier (INFERRED opt-in), confidence, point-in-time dates, counterparty entity_kind (public\/foreign\/private), evidence availability. Competitors are materiality-ranked.","auth":true,"scope":"relationships.read","params":["type","tier","direction","min_confidence","limit","offset"]},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/competitors","description":"Typed convenience view: competitors.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/customers","description":"Typed: customers.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/suppliers","description":"Typed: suppliers.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/partners","description":"Typed: partners.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/investments","description":"Typed: investments \/ M&A.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/jv","description":"Typed: joint ventures.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/licensing","description":"Typed: licensing.","auth":true,"scope":"relationships.read"},{"url":"https:\/\/api.csimarket.com\/api\/v1\/companies\/{identifier}\/distribution","description":"Typed: distribution.","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\/test\/companies\/AAPL\/relationships","description":"Free sample: AAPL counts + 5 records. No auth. Other tickers 403.","auth":false}],"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"]}],"meta_endpoints":[{"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"}],"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\/help\/licensing\/","sample_data":"https:\/\/api.csimarket.com\/api\/examples","status":"https:\/\/api.csimarket.com\/api\/status","changelog":"https:\/\/api.csimarket.com\/api\/changelog"}}