Strategia Invest API

Complete reference for Financial Data, Valuation Models, and Macroeconomics.

Referência completa para Dados Financeiros, Modelos de Valuation e Macroeconomia.

Base URL: https://strategiainvest.com.br

1. Authentication 1. Autenticação

The API uses JWT (JSON Web Tokens). You must first exchange your credentials for a token valid for 24 hours.

A API utiliza JWT (JSON Web Tokens). Você deve primeiro trocar suas credenciais por um token válido por 24 horas.

POST /api/v1/token
Headers
Authorization Required Basic Auth (Base64 encoded username:password)
Example Response Exemplo de Resposta
{ "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." }
Important: For all subsequent requests, include the token in the header: Importante: Para todas as requisições seguintes, inclua o token no header:
Authorization: Bearer <your_token>

2. Discovery Endpoints 2. Endpoints de Descoberta (Discovery)

Use these endpoints to list all available assets and find out which indicators are available for them.

Use estes endpoints para listar todos os ativos disponíveis e descobrir quais indicadores existem para eles.

Asset Lists Listas de Ativos
  • GET /api/v1/companies/cnpjs
    Returns a list of all available Company CNPJs. Retorna uma lista de todos os CNPJs de empresas disponíveis.
  • GET /api/v1/stocks/codes
    Returns a list of all available Stock Tickers. Retorna uma lista de todos os Tickers de ações disponíveis.
Indicator Discovery Descoberta de Indicadores
  • GET /api/v1/macro/indicators
  • GET /api/v1/companies/{cnpj}/indicators
  • GET /api/v1/stocks/{ticker}/indicators
Response Example (Asset List) Exemplo de Resposta (Lista de Ativos)
{ "stock_codes": [ "ABEV3", "BBAS3", "PETR4", "WEGE3", ... ] }

3. Macroeconomics 3. Macroeconomia

Access historical data for global economic indicators.

Acesse dados históricos de indicadores econômicos globais.

GET /api/v1/macro/indicators/{indicator}
Parameters Parâmetros
start_date Optional YYYY-MM-DD
end_date Optional YYYY-MM-DD
Available Indicators Indicadores Disponíveis
  • cdi_interest_rate: Daily CDI rate.Taxa CDI diária.
  • ipca_inflation: Monthly official inflation.Inflação oficial (IPCA) mensal.
  • ibovespa_index: IBOVESPA daily closing points.Fechamento diário do IBOVESPA.
  • equity_risk_premium: Implied ERP for Brazil (Damodaran).ERP Implícito Brasil (Metodologia Damodaran).
  • risk_free_rate: Calculated Risk-Free Rate.Taxa Livre de Risco (Tesouro IPCA+ Spread + IPCA Acumulado).
Example Request

GET /api/v1/macro/indicators/ipca_inflation?start_date=2023-01-01

Response Format
{ "indicator": "ipca_inflation", "count": 226, "history": [ { "date": "2007-01-01", "value": 0.44 }, ... ] }

4. Company Profile 4. Perfil da Empresa

GET /api/v1/companies/{cnpj}/info

Retrieves static data, governance info, sector, and share structure.

Retorna dados cadastrais, governança, setor e estrutura acionária.

CNPJ Format: You can send the CNPJ encoded (84.429.695%2F0001-11) or digits only (84429695000111). Formato CNPJ: Você pode enviar o CNPJ codificado (84.429.695%2F0001-11) ou apenas dígitos (84429695000111).
Example Request

GET /api/v1/companies/84429695000111/info

Response Format
{ "legal_name": "WEG SA", "cnpj": "84.429.695/0001-11", "sector_classification": "Bens Industriais / Máquinas e Equipamentos", "governance_level": "BOLSA", "free_float": { "common_percent": 35.4, "preferred_percent": 0.0, "total_percent": 35.4 }, "tickers": ["WEGE3"], "last_financial_statement": { "delivery_timestamp": "2025-10-22T08:00:24", "download_url": "https://..." } }

5. Company Indicators (History) 5. Indicadores da Empresa (Histórico)

GET /api/v1/companies/{cnpj}/indicators/{indicator}
Parameters Parâmetros
start_date Optional YYYY-MM-DD
end_date Optional YYYY-MM-DD
Example Request

GET /api/v1/companies/84429695000111/indicators/net_revenue_annual?start_date=2010-01-01

Available Indicators Reference Referência dos Indicadores Disponíveis

  • net_revenue_annual, net_revenue_quarterly (Receita Líquida)
  • gross_revenue_annual, gross_revenue_quarterly (Receita Bruta)
  • gross_profit_annual, gross_profit_quarterly (Lucro Bruto)
  • operating_income_annual, operating_income_quarterly (EBIT/Lucro Operacional)
  • ebitda_annual, ebitda_quarterly (EBITDA)
  • net_income_annual, net_income_quarterly (Lucro Líquido)
  • financial_result_annual, financial_result_quarterly (Resultado Financeiro)
  • taxes_annual, taxes_quarterly (Impostos)
  • depreciation_annual, depreciation_quarterly (Depreciação)

  • total_equity (Patrimônio Líquido)
  • current_assets, non_current_assets (Ativo Circulante / Não Circulante)
  • current_liabilities, non_current_liabilities (Passivo Circulante / Não Circulante)
  • gross_debt, net_debt (Dívida Bruta / Líquida)
  • short_term_debt, long_term_debt (Dívida CP / LP)
  • cash_and_equivalents (Caixa e Equivalentes)
  • inventory (Estoques)

  • fcff_annual: Free Cash Flow to Firm (Fluxo de Caixa Livre da Firma).
  • net_capex_annual, net_capex_quarterly
  • working_capital_change_annual (Variação de Capital de Giro)
  • roic, roe (Rentabilidade)
  • gross_margin, net_margin, ebitda_margin, operating_margin (Margens)
  • payout_ratio (Payout)
  • current_liquidity, dry_liquidity, general_liquidity (Liquidez)
  • net_debt_to_ebitda (Dívida Líquida/EBITDA), net_debt_to_ebit

  • loss_ratio_history_20y: % of years with negative net income.Proporção de anos com prejuízo.
  • cagr_net_income_history: 1y, 3y, 5y, 10y and Weighted Avg CAGR.CAGR de Lucros (1, 3, 5, 10 anos e Média Ponderada).
  • cost_of_debt_history: Estimated Kd.Custo da Dívida estimado (Kd).
  • financial_leverage_degree_history: GAF (Grau de Alavancagem Financeira).
  • value_generation_history: Market Cap growth vs Retained Earnings.Geração de Valor (Crescimento de VM vs Lucros Retidos).
  • return_on_new_invested_capital_history: RONIC (Retorno sobre Novos Investimentos).
  • ten_year_averages_history: 10y average for ROE, ROIC, Margins.Médias de 10 anos (ROE, ROIC, Margens).
  • share_capital_history: Capital Stock (See special format below).Histórico de Capital Social (Veja formato abaixo).
Special Response: Share Capital Resposta Especial: Capital Social

Indicator: share_capital_history

{ "cnpj": "84.429.695/0001-11", "count": 5, "history": [ { "date": "2021-04-28", "total_shares": 4197317998, "common_shares": 4197317998, "preferred_shares": 0 } ] }

6. Stock Snapshot (Info) 6. Ações (Info/Snapshot)

GET /api/v1/stocks/{ticker}/info

Returns market data, multiples, and the Rights/Governance structure.

Retorna dados de mercado, múltiplos e estrutura de Direitos/Governança.

Example Request

GET /api/v1/stocks/WEGE3/info

Response Format
{ "ticker": "WEGE3", "market_data": { "price": 44.23, // Raw/Unadjusted Price "pe_ratio": 27.25, "dividend_yield": 0.019 }, "rights": { "tag_along_percent": 100.0, "voting_rights": "Pleno", "dividend_rights_description": "25% do lucro líquido..." } }

7. Stock Indicators (History) 7. Histórico da Ação (Indicadores)

GET /api/v1/stocks/{ticker}/indicators/{indicator}
Parameters Parâmetros
start_date Optional YYYY-MM-DD
end_date Optional YYYY-MM-DD
Available Indicators Indicadores Disponíveis
  • price: Raw closing price (unadjusted).Preço de fechamento bruto (sem ajustes).
  • volume: Financial volume.Volume financeiro.
  • volume_moving_avg_30d: 30-day Volume Moving Average.Média Móvel de Volume (30d).
  • pe_ratio: P/E History (Price-to-Earnings).Histórico P/L (Preço/Lucro).
  • pb_ratio: P/B History (Price-to-Book).Histórico P/VP (Preço/Valor Patrimonial).
  • dividend_yield: DY History.Histórico de Dividend Yield.
  • payouts: Dividends & JCP (Special format).Dividendos e JCP (Formato especial).
Example Usage: Payouts

GET /api/v1/stocks/WEGE3/indicators/payouts?start_date=2024-01-01

Response Format (Payouts)
{ "indicator": "payouts", "history": [ { "date": "2024-12-20", // Ex-Date (Data Com) "approval_date": "2024-12-17", "payment_date": "2025-03-12", "type": "INTEREST_ON_EQUITY", "value": 0.079764706 } ] }

8. Valuation Engine (DCF & Simple) 8. Motor de Valuation (DCF e Simples)

Run dynamic valuation models. You can use default parameters or override them to create custom scenarios.

Execute modelos de valuation dinâmicos. Você pode usar os parâmetros padrão ou sobrescrevê-los para criar cenários personalizados.

Discounted Cash Flow (DCF)

Available endpoints:

Endpoints disponíveis:

  • Company: intrinsic_value_dcf_history (Fair Value / Valor Justo)
  • Stock: target_price_dcf_history (Target Price / Preço Alvo)
  • Stock: margin_of_safety_dcf_history (Margin / Margem de Segurança)
Query Parameters (Filter & Modeling) Parâmetros (Filtro e Modelagem)
Parameter Type Description
start_date YYYY-MM-DD Filter history start date (Optional). Filtrar data de início do histórico (Opcional).
end_date YYYY-MM-DD Filter history end date (Optional). Filtrar data final do histórico (Opcional).
projection_years int Years for explicit cash flow projection (Default: 3). Anos de projeção explícita de caixa (Padrão: 3).
growth_years int Lookback period for historical growth (Default: 5). Período retroativo para crescimento histórico (Padrão: 5).
terminal_growth float Perpetuity growth rate (g). Example: 0.05 (5%). Crescimento na perpetuidade (g). Exemplo: 0.05 (5%).
projection_growth_rate float / dict Override: Force a specific growth rate (g_proj).
Accepts a literal (e.g., 0.10) or a JSON object. Forçar: Impõe um crescimento específico (g_proj).
Aceita valor literal (ex: 0.10) ou objeto JSON.
discount_rate float / dict Override: Force a specific WACC/Ke rate.
Accepts a literal (e.g., 0.12) or a JSON object. Forçar: Impõe uma taxa de desconto (WACC/Ke).
Aceita valor literal (ex: 0.12) ou objeto JSON.
Example 1: Literal Override (Valor Fixo)

Force 10% growth and 12% discount rate:

Forçar 10% de crescimento e 12% de desconto:

GET /api/v1/stocks/WEGE3/indicators/target_price_dcf_history?projection_years=10&discount_rate=0.12&projection_growth_rate=0.10
Example 2: Dictionary Override (Avançado)

Pass a JSON object to vary rates over time (URL Encoded):

Passe um objeto JSON para variar taxas no tempo (URL Encoded):

GET ...&discount_rate={"2023-01-01":0.10, "2024-01-01":0.12}
Response Format (With Meta)
{ "meta": { "params": { "projection_years": 10, "discount_rate": 0.12, "terminal_growth": 0.05 } }, "history": [ { "date": "2023-12-31", "value": 45.20 } ] }
Simple Valuation Valuation Simples (Múltiplos)

Approximation of the DCF model based on the 5-year average of Net Income, discounted by the Risk-Free Rate (Treasury IPCA+).

Aproximação do modelo DCF baseada na média de Lucro Líquido dos últimos 5 anos, descontada pela Taxa Livre de Risco (Tesouro IPCA+).

start_date Optional YYYY-MM-DD Filter history start date. Filtrar data de início do histórico.
end_date Optional YYYY-MM-DD Filter history end date. Filtrar data final do histórico.
  • intrinsic_value_simple_history: Calculated Fair Value (Company).Valor Justo Calculado (Empresa).
  • target_price_simple_history: Target Price (Stock).Preço Alvo (Ação).
  • margin_of_safety_simple_history: Margin (Stock).Margem de Segurança (Ação).
Listar Filtrar Portfólios