investidor10.com.br APIinvestidor10.com.br ↗
Access Brazilian stock and FII data from Investidor10: rankings, fundamental indicators, dividend history, and historical prices via 6 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/a9c01010-767a-4206-aca7-888eb53d4d54/list_acoes?start=0&length=2' \ -H 'X-API-Key: $PARSE_API_KEY'
List top Brazilian stocks ranked by market value with fundamental indicators. Returns up to 80 stocks from the main rankings page.
| Param | Type | Description |
|---|---|---|
| start | integer | Starting index for pagination. |
| length | integer | Maximum number of results to return. |
{
"type": "object",
"fields": {
"data": "array of stock objects with ticker, name, url, valor_mercado, rate, p_l, p_vp, dividend_yield, dy_5_years, roe, net_margin, setor",
"total": "integer total number of stocks available"
},
"sample": {
"data": {
"data": [
{
"p_l": "5,35",
"roe": "24,17%",
"url": "https://investidor10.com.br/acoes/petr4/",
"name": "Petrobrás",
"p_vp": "1,29",
"rate": "90",
"setor": "Petróleo, Gás e Biocombustíveis",
"ticker": "PETR4",
"dy_5_years": "27,83%",
"net_margin": "21,60%",
"valor_mercado": "608,44 B",
"dividend_yield": "6,89%"
}
],
"total": 80
},
"status": "success"
}
}About the investidor10.com.br API
The Investidor10 API gives developers access to Brazilian equity and real estate fund data across 6 endpoints, covering everything from top-ranked stock and FII listings to per-ticker fundamental indicators and multi-currency price history. The get_acao_detalhes endpoint returns current price, dividend payment history, and a full set of indicators like P/L, P/VP, and ROE for any given ticker. FII listings via list_fiis include daily liquidity and sector classification alongside yield metrics.
Stock and FII Rankings
The list_acoes and list_fiis endpoints return the top Brazilian stocks and Real Estate Investment Funds ranked by market value, with up to 80 results per call. Both support start and length parameters for pagination. Stock objects include ticker, valor_mercado, p_l, p_vp, dividend_yield, dy_5_years, roe, net_margin, and setor. FII objects substitute liquidez_diaria for the equity-specific metrics and otherwise follow the same shape.
Per-Ticker Detail and History
get_acao_detalhes accepts a ticker string (e.g. PETR4, ITUB4) and returns the current price, an indicators map covering ratios like Dividend Yield, ROE, P/L, and P/VP, plus a dividends array with each payment's tipo, data_com, pagamento, and valor fields. The response also exposes internal ticker_id and company_id values that are referenced by the historical endpoints.
get_acao_historico_indicadores accepts a ticker and an optional years integer. It returns each tracked indicator as a key mapping to an array of yearly objects containing year, value, and metadata fields — useful for time-series analysis of valuation ratios over multiple fiscal years.
Price History and Asset Search
get_acao_cotacao_historico returns price arrays in three currencies — real (BRL), dolar (USD), and euro (EUR) — each with price and created_at timestamp fields. The days parameter controls the window of history returned. The search_ativos endpoint accepts a free-text query and returns matching assets (stocks, FIIs, BDRs) with symbol, price, variation, variation_direction, and type, alongside a news array of related articles with title, category, date, and thumbnail.
- Screen top Brazilian stocks by dividend yield, P/L, and net margin using
list_acoes - Track FII rankings by market value and daily liquidity with
list_fiisfor portfolio monitoring - Build a dividend calendar by pulling recent payment history from
get_acao_detalhes - Chart historical P/L or ROE trends year-over-year using
get_acao_historico_indicadores - Plot BRL, USD, and EUR price series for any Brazilian stock with
get_acao_cotacao_historico - Implement a ticker search bar with live asset lookup and related news via
search_ativos - Compare fundamental indicators across sectors by iterating stock objects from
list_acoes
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Investidor10 offer an official developer API?+
What does `get_acao_detalhes` return beyond the current price?+
indicators object mapping ratio names (P/L, P/VP, ROE, Dividend Yield, and others) to current numeric values, and a dividends array listing recent payments with tipo (dividend type), data_com (record date), pagamento (payment date), and valor (amount). It also returns ticker_id and company_id strings used by the historical endpoints.How far back does price history go with `get_acao_cotacao_historico`?+
days parameter you supply and the data retained by Investidor10 for that ticker. There is no documented hard cap in the endpoint spec, but very long windows may return fewer data points for tickers with limited coverage.Does the API cover FII detail pages or only FII rankings?+
list_fiis, which includes ticker, market value, P/VP, dividend yield, 5-year DY, daily liquidity, and sector. Per-FII detail pages with full indicator sets and dividend history are not exposed as a dedicated endpoint. You can fork this API on Parse and revise it to add a FII detail endpoint analogous to get_acao_detalhes.Are BDRs or options included in the rankings endpoints?+
list_acoes and list_fiis cover stocks and FIIs respectively. BDRs appear in search_ativos results (returned with a type field), but there is no dedicated BDR ranking or detail endpoint currently. You can fork this API on Parse and revise it to add BDR-specific listing or detail coverage.