Authentication
Every call needs the X-API-Key header with your API key.
curl -H "X-API-Key: SEU_TOKEN" https://visnoinvest.com/api/data/v1/stocks/PETR4Don't have a key yet? Subscribe to Pro to create one.
Endpoints
For each endpoint: a full response example and a field table. Dates are ISO 8601 (YYYY-MM-DD). Ratios and margins are decimals (0.28 = 28%). Null fields are omitted.
GET/stocksLightweight catalog of B3-listed companies — name and tickers only.
Response example
[
{ "company": "Petrobras", "tickers": ["PETR3", "PETR4"] },
{ "company": "Vale", "tickers": ["VALE3"] },
{ "company": "Itaú Unibanco", "tickers": ["ITUB3", "ITUB4"] }
]Fields
| Field | Type | Description |
|---|---|---|
company | string | Company display name |
tickers | string[] | Listed tickers for the same company |
GET/stocks/{ticker}Profile and fundamental indicators for a stock. Returns a Stock object.
Response example
{
"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
}Fields
| Field | Type | Description |
|---|---|---|
ticker | string | B3 ticker symbol |
company | string | Company display name |
cnpj | string | Company tax ID (CNPJ) |
website | string | Corporate website |
sector | string | Sector (Visno taxonomy) |
subsector | string | Subsector (Visno taxonomy) |
activity | string | Business activity description |
cvm_status | string | CVM registration status |
tickers | string[] | Listed tickers for the same company |
judicial_recovery | boolean | Whether the company is in judicial recovery |
free_float | number | Free float (decimal) |
years_listed | integer | Years since listing |
last_price_date | date | Date of the latest quote |
updated_at | date | Reference date for the indicators |
last_report_date | date | Date of the latest DFP/ITR |
next_report_date | date | Expected date of the next DFP/ITR |
price | number | Closing price |
trading_volume | number | Traded financial volume |
market_cap | number | Market capitalization |
enterprise_value | number | Enterprise value (EV) |
dy | number | Dividend yield |
vpa | number | Book value per share |
lpa | number | Earnings per share |
target_price_graham | number | Target price (Graham formula) |
net_revenue | number | Net revenue (12 months) |
gross_profit | number | Gross profit (12 months) |
net_profit | number | Net profit (12 months) |
ebit | number | EBIT (12 months) |
ebitda | number | EBITDA (12 months) |
net_worth | number | Shareholders' equity (latest report) |
assets | number | Total assets (latest report) |
liabilities | number | Total liabilities (latest report) |
cash_and_cash_equivalents | number | Cash and cash equivalents |
inventories | number | Inventories |
short_term_debt | number | Short-term debt |
long_term_debt | number | Long-term debt |
gross_debt | number | Gross debt |
net_debt | number | Net debt |
operating_cash_flow | number | Operating cash flow (12 months) |
investing_cash_flow | number | Investing cash flow (12 months) |
financing_cash_flow | number | Financing cash flow (12 months) |
capex | number | CAPEX (12 months) |
free_cash_flow | number | Free cash flow (12 months) |
net_revenue_cagr_5y | number | Net revenue CAGR (5 years) |
net_profit_cagr_5y | number | Net profit CAGR (5 years) |
ebit_cagr_5y | number | EBIT CAGR (5 years) |
ebitda_cagr_5y | number | EBITDA CAGR (5 years) |
ev_ebit_ratio | number | EV/EBIT |
ev_ebitda_ratio | number | EV/EBITDA |
ev_net_revenue_ratio | number | EV/Net revenue |
ev_assets_ratio | number | EV/Assets |
ev_free_cash_flow_ratio | number | EV/Free cash flow |
ev_operating_cash_flow_ratio | number | EV/Operating cash flow |
price_free_cash_flow_ratio | number | Price/Free cash flow |
price_operating_cash_flow_ratio | number | Price/Operating cash flow |
price_net_worth_ratio | number | P/B |
price_net_profit_ratio | number | P/E |
price_net_revenue_ratio | number | P/S |
price_assets_ratio | number | Price/Assets |
price_ebit_ratio | number | Price/EBIT |
gross_margin | number | Gross margin |
net_margin | number | Net margin |
ebit_margin | number | EBIT margin |
roic | number | ROIC |
roe | number | ROE |
roa | number | ROA |
asset_turnover | number | Asset turnover |
net_debt_ebit_ratio | number | Net debt / EBIT |
net_debt_ebitda_ratio | number | Net debt / EBITDA |
net_debt_net_worth_ratio | number | Net debt / Equity |
gross_debt_net_worth_ratio | number | Gross debt / Equity |
net_worth_assets_ratio | number | Equity / Assets |
immediate_liquidity | number | Cash ratio |
current_liquidity | number | Current ratio |
quick_liquidity | number | Quick ratio |
total_liquidity | number | Total liquidity ratio |
GET/stocks/{ticker}/quoteFull daily quote history (OHLC, adjusted close, and volume).
Response example
[
{
"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
}
]Fields
| Field | Type | Description |
|---|---|---|
date | date | Trading session date |
open | number | Opening price |
high | number | High price |
low | number | Low price |
close | number | Closing price |
adjusted_close | number | Close adjusted for corporate actions |
volume | number | Traded financial volume |
GET/stocks/{ticker}/history/{metric}Historical series for an indicator, with full history.
Parameters
| Name | In | Description |
|---|---|---|
metric* | path | Series indicator (e.g. price, dy, roe, net_profit). |
granularity | query | daily | monthly | quarterly | quarterly_ltm | yearly (optional). |
Response example
[
{ "date": "2024-01-31", "value": 38.1 },
{ "date": "2024-02-29", "value": 39.4 },
{ "date": "2024-03-31", "value": 37.2 }
]Fields
| Field | Type | Description |
|---|---|---|
date | date | Series point date |
value | number | Indicator value on that date |
Full OpenAPI specification (to auto-generate clients): openapi.json