Documentação — Visno Data API

Autenticação

Toda chamada precisa do header X-API-Key com sua chave de API.

curl -H "X-API-Key: SEU_TOKEN" https://visnoinvest.com.br/api/data/v1/stocks/PETR4

Ainda não tem uma chave? Assine o Pro para criar uma.

Endpoints

Para cada endpoint: exemplo completo da resposta e tabela de campos. Datas em ISO 8601 (YYYY-MM-DD). Ratios e margens em decimal (0.28 = 28%). Campos nulos são omitidos.

GET/stocks

Catálogo leve das empresas listadas na B3 — apenas nome e tickers.

Exemplo de resposta

[
  { "company": "Petrobras", "tickers": ["PETR3", "PETR4"] },
  { "company": "Vale", "tickers": ["VALE3"] },
  { "company": "Itaú Unibanco", "tickers": ["ITUB3", "ITUB4"] }
]

Campos

Campo	Tipo	Descrição
`company`	string	Nome de exibição da empresa
`tickers`	string[]	Tickers listados da mesma empresa

GET/stocks/{ticker}

Perfil e indicadores fundamentalistas de uma ação. Retorna um objeto Stock.

Exemplo de resposta

{
  "ticker": "PETR4",
  "company": "Petrobras",
  "cnpj": "33.000.167/0001-01",
  "website": "https://www.petrobras.com.br",
  "sector": "Petróleo, Gás e Biocombustíveis",
  "subsector": "Exploração e Produção",
  "activity": "Petróleo, gás natural e energia",
  "cvm_status": "Ativo",
  "tickers": ["PETR3", "PETR4"],
  "judicial_recovery": false,
  "free_float": 0.63,
  "years_listed": 47,
  "last_price_date": "2026-07-18",
  "updated_at": "2026-07-18",
  "last_report_date": "2026-03-31",
  "next_report_date": "2026-08-15",
  "price": 36.52,
  "trading_volume": 1250000000,
  "market_cap": 472000000000,
  "enterprise_value": 610000000000,
  "dy": 0.125,
  "vpa": 28.4,
  "lpa": 7.1,
  "target_price_graham": 42.3,
  "net_revenue": 490000000000,
  "gross_profit": 250000000000,
  "net_profit": 95000000000,
  "ebit": 140000000000,
  "ebitda": 180000000000,
  "net_worth": 380000000000,
  "assets": 1050000000000,
  "liabilities": 670000000000,
  "cash_and_cash_equivalents": 45000000000,
  "inventories": 38000000000,
  "short_term_debt": 40000000000,
  "long_term_debt": 180000000000,
  "gross_debt": 220000000000,
  "net_debt": 175000000000,
  "operating_cash_flow": 160000000000,
  "investing_cash_flow": -65000000000,
  "financing_cash_flow": -80000000000,
  "capex": 55000000000,
  "free_cash_flow": 105000000000,
  "net_revenue_cagr_5y": 0.12,
  "net_profit_cagr_5y": 0.18,
  "ebit_cagr_5y": 0.15,
  "ebitda_cagr_5y": 0.14,
  "ev_ebit_ratio": 4.3,
  "ev_ebitda_ratio": 3.4,
  "ev_net_revenue_ratio": 1.2,
  "ev_assets_ratio": 0.58,
  "ev_free_cash_flow_ratio": 5.8,
  "ev_operating_cash_flow_ratio": 3.8,
  "price_free_cash_flow_ratio": 4.5,
  "price_operating_cash_flow_ratio": 2.9,
  "price_net_worth_ratio": 1.24,
  "price_net_profit_ratio": 5.2,
  "price_net_revenue_ratio": 0.96,
  "price_assets_ratio": 0.45,
  "price_ebit_ratio": 3.4,
  "gross_margin": 0.51,
  "net_margin": 0.19,
  "ebit_margin": 0.28,
  "roic": 0.19,
  "roe": 0.28,
  "roa": 0.09,
  "asset_turnover": 0.47,
  "net_debt_ebit_ratio": 1.25,
  "net_debt_ebitda_ratio": 0.97,
  "net_debt_net_worth_ratio": 0.46,
  "gross_debt_net_worth_ratio": 0.58,
  "net_worth_assets_ratio": 0.36,
  "immediate_liquidity": 0.35,
  "current_liquidity": 1.2,
  "quick_liquidity": 0.9,
  "total_liquidity": 1.5
}

Campos

Campo	Tipo	Descrição
`ticker`	string	Código do ticker na B3
`company`	string	Nome de exibição da empresa
`cnpj`	string	CNPJ da empresa
`website`	string	Site institucional
`sector`	string	Setor (taxonomia Visno)
`subsector`	string	Subsetor (taxonomia Visno)
`activity`	string	Descrição da atividade
`cvm_status`	string	Status do registro na CVM
`tickers`	string[]	Tickers listados da mesma empresa
`judicial_recovery`	boolean	Se a empresa está em recuperação judicial
`free_float`	number	Free float (decimal)
`years_listed`	integer	Anos desde o listing
`last_price_date`	date	Data da última cotação
`updated_at`	date	Data de referência dos indicadores
`last_report_date`	date	Data do último DFP/ITR
`next_report_date`	date	Data prevista do próximo DFP/ITR
`price`	number	Preço de fechamento
`trading_volume`	number	Volume financeiro negociado
`market_cap`	number	Valor de mercado
`enterprise_value`	number	Enterprise value (EV)
`dy`	number	Dividend yield
`vpa`	number	Valor patrimonial por ação
`lpa`	number	Lucro por ação
`target_price_graham`	number	Preço-alvo (fórmula de Graham)
`net_revenue`	number	Receita líquida (12 meses)
`gross_profit`	number	Lucro bruto (12 meses)
`net_profit`	number	Lucro líquido (12 meses)
`ebit`	number	EBIT (12 meses)
`ebitda`	number	EBITDA (12 meses)
`net_worth`	number	Patrimônio líquido (último balanço)
`assets`	number	Ativo total (último balanço)
`liabilities`	number	Passivo total (último balanço)
`cash_and_cash_equivalents`	number	Caixa e equivalentes
`inventories`	number	Estoques
`short_term_debt`	number	Dívida de curto prazo
`long_term_debt`	number	Dívida de longo prazo
`gross_debt`	number	Dívida bruta
`net_debt`	number	Dívida líquida
`operating_cash_flow`	number	Fluxo de caixa operacional (12 meses)
`investing_cash_flow`	number	Fluxo de caixa de investimento (12 meses)
`financing_cash_flow`	number	Fluxo de caixa de financiamento (12 meses)
`capex`	number	CAPEX (12 meses)
`free_cash_flow`	number	Fluxo de caixa livre (12 meses)
`net_revenue_cagr_5y`	number	CAGR da receita líquida (5 anos)
`net_profit_cagr_5y`	number	CAGR do lucro líquido (5 anos)
`ebit_cagr_5y`	number	CAGR do EBIT (5 anos)
`ebitda_cagr_5y`	number	CAGR do EBITDA (5 anos)
`ev_ebit_ratio`	number	EV/EBIT
`ev_ebitda_ratio`	number	EV/EBITDA
`ev_net_revenue_ratio`	number	EV/Receita líquida
`ev_assets_ratio`	number	EV/Ativos
`ev_free_cash_flow_ratio`	number	EV/Fluxo de caixa livre
`ev_operating_cash_flow_ratio`	number	EV/Fluxo de caixa operacional
`price_free_cash_flow_ratio`	number	Preço/Fluxo de caixa livre
`price_operating_cash_flow_ratio`	number	Preço/Fluxo de caixa operacional
`price_net_worth_ratio`	number	P/VP
`price_net_profit_ratio`	number	P/L
`price_net_revenue_ratio`	number	P/SR
`price_assets_ratio`	number	Preço/Ativos
`price_ebit_ratio`	number	Preço/EBIT
`gross_margin`	number	Margem bruta
`net_margin`	number	Margem líquida
`ebit_margin`	number	Margem EBIT
`roic`	number	ROIC
`roe`	number	ROE
`roa`	number	ROA
`asset_turnover`	number	Giro do ativo
`net_debt_ebit_ratio`	number	Dívida líquida / EBIT
`net_debt_ebitda_ratio`	number	Dívida líquida / EBITDA
`net_debt_net_worth_ratio`	number	Dívida líquida / Patrimônio líquido
`gross_debt_net_worth_ratio`	number	Dívida bruta / Patrimônio líquido
`net_worth_assets_ratio`	number	Patrimônio líquido / Ativos
`immediate_liquidity`	number	Liquidez imediata
`current_liquidity`	number	Liquidez corrente
`quick_liquidity`	number	Liquidez seca
`total_liquidity`	number	Liquidez geral

GET/stocks/{ticker}/quote

Histórico completo de cotações diárias (OHLC, close ajustado e volume).

Exemplo de resposta

[
  {
    "date": "2026-07-17",
    "open": 35.80,
    "high": 36.20,
    "low": 35.50,
    "close": 36.00,
    "adjusted_close": 36.00,
    "volume": 980000000
  },
  {
    "date": "2026-07-18",
    "open": 36.10,
    "high": 36.80,
    "low": 35.90,
    "close": 36.52,
    "adjusted_close": 36.52,
    "volume": 1250000000
  }
]

Campos

Campo	Tipo	Descrição
`date`	date	Data do pregão
`open`	number	Preço de abertura
`high`	number	Preço máximo
`low`	number	Preço mínimo
`close`	number	Preço de fechamento
`adjusted_close`	number	Fechamento ajustado por proventos e eventos corporativos
`volume`	number	Volume financeiro negociado

GET/stocks/{ticker}/history/{metric}

Série histórica de um indicador, com histórico completo.

Parâmetros

Nome	Onde	Descrição
`metric`*	path	Indicador da série (ex.: price, dy, roe, net_profit).
`granularity`	query	daily \| monthly \| quarterly \| quarterly_ltm \| yearly (opcional).

Exemplo de resposta

[
  { "date": "2024-01-31", "value": 38.1 },
  { "date": "2024-02-29", "value": 39.4 },
  { "date": "2024-03-31", "value": 37.2 }
]

Campos

Campo	Tipo	Descrição
`date`	date	Data do ponto na série
`value`	number	Valor do indicador na data

Especificação OpenAPI completa (gera clientes automaticamente): openapi.json