statusinvest.com.br APIstatusinvest.com.br ↗
Access Brazilian stock search, financial indicators, price history, dividends, and full stock listings from StatusInvest via a single REST API.
curl -X GET 'https://api.parse.bot/scraper/e22d137f-9aa8-4df2-8485-91eeea290359/search?query=PETR' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for stocks by ticker symbol or company name. Returns matching stocks and BDRs with current price and daily variation.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search query — a ticker symbol (e.g. PETR4) or company name (e.g. Petrobras). |
{
"type": "object",
"fields": {
"data": "array of matching stock objects, each containing code (ticker), name, price, variation, and url"
},
"sample": {
"data": [
{
"id": 530,
"url": "/acoes/petr4",
"code": "PETR4",
"name": "PETROBRAS",
"type": 1,
"price": "45,19",
"parentId": 408,
"variation": "1,390",
"variationUp": true,
"nameFormated": "PETR4 - PETROBRAS"
}
],
"status": "success"
}
}About the statusinvest.com.br API
The StatusInvest API exposes 5 endpoints covering the full breadth of Brazilian equity data available on statusinvest.com.br — from ticker search and detailed indicators like P/L, ROE, and dividend yield to approximately 30 days of daily closing prices. The get_details endpoint returns a structured indicator object for any B3-listed ticker, while list_stocks delivers the complete universe of Brazilian equities with valuation metrics in one call.
What the API Covers
This API targets Brazilian equities listed on B3, including stocks and BDRs. The search endpoint accepts a ticker symbol (e.g. PETR4) or company name (e.g. Petrobras) and returns an array of matching instruments, each with code, name, price, variation, and url. The get_details endpoint takes a single ticker parameter and returns an indicators object mapping named financial metrics — P/L, P/VP, ROE, DY, profit margins, and others — alongside a summary object with current price and related fields.
Price History and Dividends
The get_history endpoint returns recent daily closing prices in BRL for a given ticker, covering approximately the last 30 trading days. The response is structured as an array of currency objects, each containing currency metadata and a prices array of date/price pairs. The get_dividends endpoint queries dividend events by year and month (both optional, defaulting to the current UTC period) and returns two arrays: announced (upcoming dividend announcements) and payments (confirmed paid events).
Full Stock Universe
The list_stocks endpoint requires no parameters and returns the complete set of B3-listed stocks. Each object in the response includes companyid, companyname, ticker, price, and a wide set of financial metrics: dy, p_l, p_vp, roe, roa, liquidity measures, and market cap. This makes it suitable for screening the full Brazilian equity market without needing to enumerate tickers in advance.
- Screen all B3-listed stocks by P/L, P/VP, or ROE using
list_stocksfinancial metric fields. - Build a dividend calendar by querying
get_dividendsmonth-by-month to track announced and paid events. - Power a ticker autocomplete feature with
searchusing partial company names or ticker symbols. - Plot a 30-day price chart for any Brazilian stock using
get_historydate/price pairs. - Monitor current DY, margin, and valuation indicators for a watchlist of tickers via
get_details. - Compare P/VP and ROE across the full stock universe to identify valuation outliers.
- Aggregate dividend payment history for income-focused portfolio tracking.
| 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 StatusInvest have an official developer API?+
What does `get_details` return beyond the current price?+
indicators object mapping named financial ratios and metrics to their values — including P/L, P/VP, ROE, dividend yield, and profit margins — and a summary object containing the current price and closely related fields for the requested ticker.How far back does `get_history` go for price data?+
Does the API cover FIIs (real estate investment trusts) or other Brazilian asset classes beyond stocks and BDRs?+
Can I filter `list_stocks` results by sector or minimum liquidity?+
list_stocks endpoint returns the full stock universe in a single unfiltered response — it has no built-in filter parameters. Filtering by sector, liquidity threshold, or any other criterion needs to be applied client-side on the returned array. You can fork the API on Parse and revise it to add server-side filtering logic.