Skip to main content

Company Fundamentals

Company Data

Returns detailed, structured data on a specific company, identified by its exchange and ticker.
The response always includes basic company info (info) and can be expanded with additional data blocks via the include parameter.

Use this endpoint to access the complete company profile, including fundamentals, financials, insider activity, dividends, operations, ownership, and investment ideas.

API Reference

Method Path Description
GET /v2/stocks/{exchange}:{code} Retrieve detailed data for a specific company

Query Parameters

Key Type Location Required Description
exchange string path Exchange code (e.g. MOEX, KASE)
code string path Company ticker (e.g. GAZP)
include string query Comma-separated list of data blocks to include

Base Model Schema

{
  "info": { ... },
  "summary": { ... },
  "ratios": [ ... ],
  "reports": [ ... ],
  "dividends": [ ... ],
  "insiderTransactions": [ ... ],
  "owners": [ ... ],
  "shares": [ ... ],
  "operations": [ ... ]
}
  • info is always included
  • Other blocks are included only if explicitly listed in the include parameter

Info (always included)

Basic company profile: general identifiers, classification (industry, sector), listing info, report frequency, and website.

Field Type Description
changed_at string (ISO) Last update timestamp
code string Ticker symbol (e.g. GAZP)
country string Country of incorporation/listing
currency string Trading currency
description string Short company description
disc_link string (URL) Link to disclosure page
exchange string Exchange code (e.g. MOEX)
industry string Industry classification
industry_group string Industry group name
industry_group_id integer Industry group ID
industry_id integer Industry ID
name string Full company name
primary_report_code string Ticker used in financial reports
primary_report_exchange string Exchange used in reports
report_frequency string Reporting frequency (quarterly, annual, etc.)
sector string Sector name
sector_id integer Sector ID
site string (URL) Official website
spb boolean Listed on SPB Exchange (true or false)
sub_industry string Sub-industry name
sub_industry_id integer Sub-industry ID

Summary

High-level growth, dividend, and consensus snapshot: valuation potential (PEG, targets), dividend history stats, 3–5 year growth rates, and analyst sentiment.

Field Type Description
capital number Market capitalization
changed_at string Last update timestamp (ISO 8601)
dividend_frequency integer Number of dividend payouts per year
dividend_gap_average integer Average gap close duration after dividend, in days
dividend_gap_last integer Last observed gap close duration, in days
dividend_growth integer Consecutive years of dividend growth
dividend_index number Dividend attractiveness index
dividend_strike integer Number of years dividends were paid without interruption
dividend_yield_12m number Trailing 12-month dividend yield (%)
dividend_yield_3y number 3-year average dividend yield (%)
dividend_yield_5y number 5-year average dividend yield (%)
eps number Earnings per share
graham_target number Target price based on Graham formula
growth_assets_3y number 3-year average growth in assets (%)
growth_assets_5y number 5-year average growth in assets (%)
growth_earnings_3y number 3-year average earnings growth (%)
growth_earnings_5y number 5-year average earnings growth (%)
growth_ebitda_3y number 3-year average EBITDA growth (%)
growth_ebitda_5y number 5-year average EBITDA growth (%)
growth_equity_3y number 3-year average equity growth (%)
growth_equity_5y number 5-year average equity growth (%)
growth_fcf_3y number 3-year average free cash flow growth (%)
growth_fcf_5y number 5-year average free cash flow growth (%)
growth_netdebt_3y number 3-year average change in net debt (%)
growth_netdebt_5y number 5-year average change in net debt (%)
growth_operation_3y number 3-year average operating profit growth (%)
growth_operation_5y number 5-year average operating profit growth (%)
growth_revenue_3y number 3-year average revenue growth (%)
growth_revenue_5y number 5-year average revenue growth (%)
idea_buy integer Number of active "buy" recommendations
idea_consensus string Consensus rating (buy, hold, sell)
idea_hold integer Number of active "hold" recommendations
idea_potential number Average expected upside (%) from consensus
idea_sell integer Number of active "sell" recommendations
idea_target number Consensus target price
insider_consensus string General insider sentiment (e.g. bullish, neutral)
peg number PEG ratio
peter_lynch_target number Target price based on Peter Lynch's method

Dividends

List of historical and upcoming dividends: amount, yield, dates (last buy, registry close), and dividend type.

Field Type Description
changed_at string (ISO) Last update timestamp
code string Ticker symbol (e.g. GAZP)
div_amount number Dividend amount per share
div_curr string Dividend currency (e.g. RUB)
div_percent number Dividend yield (%)
exchange string Exchange code (e.g. MOEX)
last_buy_date string (date) Last day to purchase shares to receive dividend
last_buy_price number Share price on last buy date
link string (URL) Source link
reestr_close_date string (date) Registry close date (ex-dividend date)
type string Type of dividend (e.g. regular, interim)
year integer Year the dividend was declared

Ratios

Financial ratios and valuation metrics by reporting period: P/E, ROE, EV/EBITDA, margins, debt ratios, etc.

Field Type Description
active boolean Whether this is the latest period
capex_revenue number CAPEX to Revenue ratio
capital number Market capitalization
changed_at string (ISO) Last update timestamp
code string Ticker symbol (e.g. GAZP)
current_ratio number Current Ratio
debt_equity number Debt-to-Equity ratio
debt_ratio number Debt Ratio
debtebitda number Debt to EBITDA
dpr number Dividend Payout Ratio (deprecated)
ebitda_margin number EBITDA margin (%)
ev_ebit number EV/EBIT
evebitda number EV/EBITDA
evs number EV/Sales (EV/S)
exchange string Exchange code (e.g. MOEX)
gross_margin number Gross margin (%)
interest_coverage number Interest Coverage Ratio
month integer Reporting month
net_margin number Net margin (%)
net_working_capital number Net Working Capital Ratio
netdebt_ebitda number Net Debt to EBITDA
operation_margin number Operating margin (%)
pbv number Price to Book Value (P/BV)
pcf number Price to Cash Flow (P/CF)
pe number Price to Earnings (P/E)
period string Reporting period (e.g. 2023Q2)
pfcf number Price to Free Cash Flow (P/FCF)
pffo number Price to Funds From Operations (P/FFO)
ps number Price to Sales (P/S)
roa number Return on Assets (ROA)
roce number Return on Capital Employed (ROCE)
roe number Return on Equity (ROE)
roic number Return on Invested Capital (ROIC)
ros number Return on Sales (ROS)
type string Report type (annual, quarterly, etc.)
year integer Reporting year

Reports

Detailed financial statements for each reporting period: income statement, balance sheet, cash flow, capital expenditures, and liquidity indicators.

Field Type Description
accounts_payable integer Total accounts payable
accounts_payable_current integer Current accounts payable
accounts_payable_long integer Long-term accounts payable
accounts_receivable integer Total accounts receivable
accounts_receivable_current integer Current accounts receivable
accounts_receivable_long integer Long-term accounts receivable
amount integer Unit multiplier (e.g. values in thousands)
capex integer Capital expenditures
cash_and_equiv integer Cash and equivalents
cash_paid_for_interest integer Interest paid (cash flow)
cff integer Cash flow from financing activities
cfi integer Cash flow from investing activities
cfo integer Cash flow from operating activities
changed_at string Last update timestamp
code string Ticker symbol (e.g. GAZP)
commission_expense integer Commission expenses
commission_income integer Commission income
commission_net integer Net commission income
cost_of_sales integer Cost of goods sold
cur_long_debt integer Total debt (short + long term)
cur_long_lease integer Total lease obligations
curr string Currency
current_assets integer Current assets
current_debt integer Current debt
current_lease integer Current lease obligations
current_liabilities integer Current liabilities
depr_depl_amort integer Depreciation, depletion and amortization
earnings integer Net income
earnings_ps number Earnings per share
earnings_stock_holders integer Earnings attributable to shareholders
earnings_wo_tax integer Earnings before tax
ebit integer Earnings before interest and taxes
ebitda integer EBITDA
ebitda_ps number EBITDA per share
equity integer Total equity
equity_ps number Equity per share
equity_stock_holders integer Shareholder equity
exchange string Exchange code (e.g. MOEX)
fcf integer Free cash flow
fcf_ps number Free cash flow per share
ffo integer Funds from operations
goodwill integer Goodwill
gross_profit integer Gross profit
intangibles_purchase integer Purchase of intangible assets
interest_expense integer Interest expense
interest_income integer Interest income
interest_net integer Net interest
inventories integer Inventories
issuance_of_debt integer New debt issued
link string (URL) Source link to the report
link_press string (URL) Link to investor presentation
link_update string (URL) Link to updated report
long_term_assets integer Non-current assets
long_term_debt integer Long-term debt
long_term_investments integer Long-term investments
long_term_lease integer Long-term lease liabilities
long_term_liabilities integer Long-term liabilities
month integer Reporting month
net_debt integer Net debt
net_issuance_of_debt integer Net debt repayment
operating_income integer Operating income
payments_for_dividends integer Dividend payments
payments_of_debt integer Debt repayments
period string Reporting period (e.g. 2023Q2)
ppe_purchase integer Purchase of property, plant & equipment
preliminary boolean Whether the report is preliminary
property_plant_equipment integer Book value of PPE
repurchase_of_stock integer Share buybacks
research_and_development integer R&D expenses
retained_earnings integer Retained earnings
revenue integer Revenue
revenue_ps number Revenue per share
sel_gen_adm_expenses integer SG&A expenses
share_premium integer Share premium
total_assets integer Total assets
total_debt integer Total debt
total_expenses integer Total operating expenses
total_liabilities integer Total liabilities
type string Report type (e.g. annual, quarterly)
year integer Reporting year

InsiderTransactions

List of insider trades: buy/sell actions, transaction dates, amounts, prices, and changes in ownership.

Field Type Description
amount number Number of shares involved in the transaction
approximate boolean Whether the transaction data is an approximation
changed_at string (ISO) Last update timestamp
code string Ticker symbol (e.g. GAZP)
exchange string Exchange code (e.g. MOEX)
filling_date string (date) Date the transaction was disclosed
link string (URL) Source link to the disclosure
own_after number Ownership percentage after the transaction
own_before number Ownership percentage before the transaction
owner string Name of the insider
owner_title string Insider’s title or position
price number Price per share
shares_after number Number of shares held after the transaction
shares_before number Number of shares held before the transaction
transaction_date string (date) Date when the transaction took place
transaction_type string Type of transaction (e.g. buy, sell)
value number Total value of the transaction

Ideas

Investment ideas and target scenarios from broker communities or analysts: entry/target prices, expected profit, and community name.

Field Type Description
changed_at string (ISO) Last update timestamp
close_comment string Reason for closing the idea
close_date string (date) Date when the idea was closed
close_link string (URL) Link to the closure source
close_price number Closing price of the idea
code string Ticker symbol (e.g. GAZP)
community string Name of the community that published the idea
community_id integer ID of the community
date_in string (date) Entry date of the idea
date_out string (date) Planned exit date
duration_in_month integer Duration in months
exchange string Exchange code (e.g. MOEX)
id integer Unique idea ID
idea string Title of the investment idea
link string (URL) Source link
price_day number Current market price
price_in number Entry price
price_out number Target price
profit_actual number Realized return at closing
profit_potential number Projected annualized return
stop_loss number Stop-loss level
system_status string Current status (e.g. open, closed, hold)
update_comment string Reason for update
update_date string (date) Date of last update
update_link string (URL) Source link for the update
update_price number Updated target price

Owners

Major shareholders data: who owns how much of the company over time, typically by year/month.

Field Type Description
changed_at string (ISO) Last update timestamp
code string Ticker symbol (e.g. GAZP)
exchange string Exchange code (e.g. MOEX)
link string (URL) Source link
month integer Month of the ownership record
own string Ownership share (e.g. 15.24%)
owner string Name of the shareholder
year integer Year of the ownership record

Shares

Share count over time: number of shares outstanding by month or year — useful for dilution analysis or per-share metrics.

Field Type Description
changed_at string (ISO) Last update timestamp
code string Ticker symbol (e.g. GAZP)
exchange string Exchange code (e.g. MOEX)
month integer Month of the share record
num integer Number of shares
year integer Year of the share record

Operations

Operational metrics (if available): standardized indicators like production volume, reserves, consumption, etc., by period.

Field Type Description
amount integer Standardized value multiplier (e.g. 1000)
code string Ticker symbol (e.g. GAZP)
curs number Conversion rate between original and standardized units
exchange string Exchange code (e.g. MOEX)
link string (URL) Source link
link_update string (URL) Update source link
month integer Month of the operational data
operation_metric_id string Operation metric code (e.g. gold_produced)
original_amount integer Original value multiplier (e.g. 1000)
original_unit string Original unit (e.g. oz)
original_value number Original reported value
period string Reporting period
unit string Standardized unit (e.g. oz)
value number Standardized value
year integer Year of the operational data

Use Cases 1: Basic info

Scenario

A client wants to retrieve basic company profile data — such as name, industry, exchange, and description — for display or lookup purposes. No additional data blocks are requested.

Request

GET /v2/stocks/MOEX:GAZP?token=<YOUR_API_TOKEN>

Response

{
  "info": {
    "changed_at": "2025-06-25T16:20:29.461Z",
    "code": "GAZP",
    "country": "Russia",
    "currency": "RUB",
    "description": "Gazprom is a large Russian energy company engaged in the extraction, production, transport, and sale of natural gas.",
    "disc_link": "https://www.e-disclosure.ru/portal/company.aspx?id=1234",
    "exchange": "MOEX",
    "industry": "Oil & Gas Exploration and Production",
    "industry_group": "Energy",
    "industry_group_id": 101,
    "industry_id": 1001,
    "name": "Gazprom",
    "primary_report_code": "GAZP",
    "primary_report_exchange": "MOEX",
    "report_frequency": "Annual",
    "sector": "Energy",
    "sector_id": 10,
    "site": "https://www.gazprom.ru",
    "spb": true,
    "sub_industry": "Integrated Oil & Gas",
    "sub_industry_id": 10001
  }
}

Use Cases 2: Fundamentals

Scenario

A client is evaluating the company's valuation metrics and fundamentals, such as P/E ratios, margins, and financial statements. They include ratios, reports, and summary in the request to build a detailed analytics dashboard.

Request

GET /v2/stocks/MOEX:GAZP?include=ratios,reports,summary&token=<YOUR_API_TOKEN>

Response

{
  "info": {...},
  "ratios": [
    {
      "code": "GAZP",
      "exchange": "MOEX",
      "year": 2024,
      "period": "12M",
      "pe": 4.8,
      "pbv": 0.6,
      "roe": 18.2,
      "gross_margin": 45.1,
      "ebitda_margin": 33.4,
      "changed_at": "2025-06-20T12:00:00Z",
      ...
    },
    ...
  ],
  "reports": [
    {
      "code": "GAZP",
      "exchange": "MOEX",
      "year": 2024,
      "period": "12M",
      "revenue": 1020000000,
      "earnings": 210000000,
      "ebitda": 340000000,
      "equity": 1600000000,
      "total_assets": 2500000000,
      "total_liabilities": 900000000,
      "cash_and_equiv": 180000000,
      "changed_at": "2025-06-21T08:10:00Z",
      ...
    },
    ...
  ],
  "summary": {
    "capital": 640000000000,
    "dividend_yield_12m": 8.1,
    "peg": 0.5,
    "idea_consensus": "buy",
    "idea_potential": 22.4,
    "eps": 20.5,
    "growth_revenue_3y": 7.2,
    "growth_earnings_3y": 12.6,
    "dividend_growth": 4,
    "changed_at": "2025-06-23T14:30:00Z",
    ...
  }
}

Use Cases 3: Dividends & Insiders

Scenario

An investor wants to explore a company’s dividend track record along with recent insider buying and selling activity to assess potential market signals.

Request

GET /v2/stocks/MOEX:GAZP?include=dividends,insider_transactions&token=<YOUR_API_TOKEN>

Response

{
  "info": {...},
  "dividends": [
    {
      "code": "GAZP",
      "exchange": "MOEX",
      "year": 2024,
      "div_amount": 52.3,
      "div_curr": "RUB",
      "div_percent": 9.8,
      "last_buy_date": "2024-06-25",
      "reestr_close_date": "2024-06-27",
      "type": "final",
      "link": "https://www.gazprom.ru/disclosure/dividends",
      "changed_at": "2025-06-20T10:45:00Z"
    },
    ...
  ],
  "insiderTransactions": [
    {
      "code": "GAZP",
      "exchange": "MOEX",
      "transaction_date": "2025-04-02",
      "filling_date": "2025-04-04",
      "owner": "Ivan Ivanov",
      "owner_title": "Board Member",
      "transaction_type": "buy",
      "amount": 100000,
      "price": 158.2,
      "value": 15820000,
      "own_before": 0.012,
      "own_after": 0.017,
      "approximate": false,
      "link": "https://disclosure.gazprom.ru/insider/txn/20250404",
      "changed_at": "2025-06-18T09:00:00Z"
    },
    ...
  ]
}

Get Your Trial Access

To use this endpoint, you need an API token.

We provide demo access within 1 business day — just contact us at api@cisfundamentals.com with a brief description of your use case.