Reference
REST endpoints
The public Bolsix v1 surface, extracted from the production FastAPI routes. Open the machine-readable schema for full request and response models.
Market data
Quotes, prices, the instrument universe, and market-wide snapshots from B3.
/v1/stocks/quoteQuotes
Latest quote snapshots for up to 100 comma-separated B3 symbols.
symbols · fields?
/v1/stocks/pricesHistorical prices
Daily, weekly, or monthly OHLCV with raw, split-adjusted, or total-return prices.
symbol · interval? · start_date? · end_date? · limit? · cursor? · adjust?
/v1/stocks/listInstrument universe
Active stocks, FIIs, BDRs, and ETFs with identity and listing metadata. Search by company name or ticker prefix.
name? · asset_class? · sector? · limit? · offset?
/v1/stocks/bulk/quotesBulk quotes
The complete cached active B3 quote universe in one request.
No parameters
/v1/stocks/corporate-actionsCorporate actions
Splits, reverse splits, bonuses, renames, and ticker lineage.
symbol
Fundamentals & disclosures
Normalized CVM filings, ratios, statements, dividends, and source links.
/v1/stocks/fundamentalsFundamentals
Valuation, profitability, leverage, and dividend metrics from DFP/ITR filings.
symbol · period? · limit?
/v1/stocks/statementsFinancial statements
Income, balance sheet, or cash-flow rows with filing provenance and point-in-time queries.
symbol · statement? · period? · limit? · as_of?
/v1/stocks/dividendsDividends & JCP
Cash distributions with dividends and JCP preserved as distinct event types.
symbol · limit? · event_type? · start_date? · end_date? · cursor?
/v1/stocks/filingsCVM filings
Company disclosures with canonical CVM document URLs and cursor pagination.
symbol · category? · since? · limit? · cursor?
/v1/stocks/calendarResults calendar
DFP/ITR deliveries, market-wide or for one company, with symbols and source documents.
symbol? · since? · until? · limit?
/v1/stocks/screenStock screener
Filter the latest fundamentals across B3 by valuation, quality, income, size, and sector.
asset_class? · sector? · min/max ratios · sort_by? · sort_order? · limit?
Macro & FIIs
Brazilian macro series and structured real-estate fund portfolios.
/v1/macro/ratesCurrent rates
Latest SELIC, CDI, IPCA, and IPCA 12-month values from BCB-backed data.
No parameters
/v1/macro/currencyPTAX
Latest official USD/BRL PTAX buy and sell rates.
No parameters
/v1/macro/seriesMacro time series
Historical warehouse series for rates, FX, inflation, and GDP.
series_id · start_date? · end_date? · limit?
/v1/fii/portfolioFII portfolio
Portfolio allocation, NAV, holders, properties, vacancy, and delinquency from CVM informes.
symbol
Watchlists
Account-scoped portfolios and a server-computed research briefing.
/v1/watchlistGet watchlist
Return the authenticated account's symbols.
No parameters
/v1/watchlistReplace watchlist
Replace the watchlist with up to 200 symbols.
JSON: { symbols: string[] }
/v1/watchlist/addAdd symbols
Add valid B3 symbols without replacing existing entries.
JSON: { symbols: string[] }
/v1/watchlist/removeRemove symbols
Remove one or more symbols from the watchlist.
JSON: { symbols: string[] }
/v1/watchlist/briefingWatchlist briefing
New filings, financial deltas, distributions, yield, and price per ticker in one workflow.
since? · filings_per_ticker?