Bolsai — Financial Data API for Brazil
Financial data API for the Brazilian market. 27+ fundamental indicators, 350+ stocks, 400+ FIIs, 40 years of historical data. Official data from B3, CVM, and BCB.
2 subscribers
40 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Bolsai — Financial Data API for Brazil endpoints
| Method | Endpoint | Description |
|---|---|---|
| api-keys | ||
| GET |
get_usage_api_v1_keys_usage_get /api/v1/keys/usage |
Check current API key usage and limits. |
| GET |
get_playground_token_api_v1_keys_playground_token_get /api/v1/keys/playground-token |
Generate a short-lived token for the website playground. |
| POST |
register_api_key_api_v1_keys_register_post /api/v1/keys/register |
Register a new free-tier API key. |
| companies | ||
| GET |
list_companies_api_v1_companies__get /api/v1/companies/ |
|
| GET |
get_company_api_v1_companies__ticker__get /api/v1/companies/{ticker} |
|
| GET |
list_sectors_api_v1_companies_sectors_get /api/v1/companies/sectors |
List all sectors with company counts. Only includes active companies with tickers. |
| stocks | ||
| GET |
stock_corporate_events_api_v1_stocks__ticker__corporate_events_get /api/v1/stocks/{ticker}/corporate-events |
Detect splits and reverse splits from price history. |
| GET |
list_tickers_api_v1_stocks__get /api/v1/stocks/ |
|
| GET |
ticker_history_api_v1_stocks__ticker__ticker_history_get /api/v1/stocks/{ticker}/ticker-history |
Show all historical tickers for a company (rename chain). |
| GET |
stock_stats_api_v1_stocks__ticker__stats_get /api/v1/stocks/{ticker}/stats |
Price statistics: 52-week high/low, YTD return, daily change, avg volume. |
| GET |
stock_quote_api_v1_stocks__ticker__quote_get /api/v1/stocks/{ticker}/quote |
|
| GET |
stock_history_api_v1_stocks__ticker__history_get /api/v1/stocks/{ticker}/history |
|
| GET |
all_corporate_events_api_v1_stocks_corporate_events_get /api/v1/stocks/corporate-events |
List all detected splits and reverse splits across all tickers. |
| fundamentals | ||
| GET |
get_fundamentals_history_api_v1_fundamentals__ticker__history_get /api/v1/fundamentals/{ticker}/history |
Get historical fundamentals (one per quarter, most recent first). |
| GET |
get_fundamentals_api_v1_fundamentals__ticker__get /api/v1/fundamentals/{ticker} |
Get fundamental indicators by ticker. Uses the most recent DFP or ITR data available. Calculates P/L, EV/EBITDA, ROE, net margin, debt/equity. |
| financials | ||
| GET |
get_financials_api_v1_financials__ticker__get /api/v1/financials/{ticker} |
|
| dividends | ||
| GET |
get_dividends_api_v1_dividends__ticker__get /api/v1/dividends/{ticker} |
Get dividend history and yield for a ticker. |
| fiis | ||
| GET |
get_fii_distributions_api_v1_fiis__ticker__distributions_get /api/v1/fiis/{ticker}/distributions |
Get FII distribution history: monthly R$/share, annual totals, trailing 12m yield. |
| GET |
list_fiis_api_v1_fiis__get /api/v1/fiis/ |
List all FII tickers with latest data. |
| GET |
get_fii_fundamentals_api_v1_fiis__ticker__get /api/v1/fiis/{ticker} |
Get FII fundamentals: P/VP, DY, NAV, shareholders. |
| GET |
get_fii_history_api_v1_fiis__ticker__history_get /api/v1/fiis/{ticker}/history |
Get FII monthly history: P/VP, DY, NAV evolution. |
| screener | ||
| GET |
screen_stocks_api_v1_screener__get /api/v1/screener/ |
Screen stocks by fundamental metrics. Scans all ~264 traded companies. Use {metric}_gt and {metric}_lt query params to filter (e.g. ?pl_lt=15&roe_gt=10÷nd_yield_gt=5). |
| macro | ||
| GET |
list_series_api_v1_macro__get /api/v1/macro/ |
|
| GET |
get_series_api_v1_macro__series_name__get /api/v1/macro/{series_name} |
|
| health | ||
| GET |
health_check_health_get /health |
|
| auth | ||
| GET |
google_login_api_v1_auth_google_get /api/v1/auth/google |
Redirect user to Google OAuth consent screen. |
| GET |
google_callback_api_v1_auth_google_callback_get /api/v1/auth/google/callback |
Handle Google OAuth callback. |
| GET |
get_current_user_api_v1_auth_me_get /api/v1/auth/me |
Get current logged-in user info and usage stats. |
| GET |
check_admin_api_v1_auth_check_admin_get /api/v1/auth/check-admin |
Check if current session is admin. Used by nginx auth_request. |
| GET |
logout_api_v1_auth_logout_get /api/v1/auth/logout |
Clear session and redirect to home. |
| oauth | ||
| GET |
authorize_api_v1_oauth_authorize_get /api/v1/oauth/authorize |
Start OAuth flow: redirect user to Google login. ChatGPT sends: GET /oauth/authorize?client_id=bolsai&redirect_uri=https://chat.openai.com/...&state=xyz&response_type=code We… |
| POST |
token_api_v1_oauth_token_post /api/v1/oauth/token |
Exchange authorization code for API key (as access_token). ChatGPT sends: POST /oauth/token Content-Type: application/x-www-form-urlencoded… |
| GET |
callback_api_v1_oauth_callback_get /api/v1/oauth/callback |
Handle Google callback, then redirect back to the third-party app with an auth code. |
| billing | ||
| POST |
stripe_webhook_api_v1_billing_webhook_post /api/v1/billing/webhook |
Handle Stripe webhook events. |
| POST |
create_checkout_api_v1_billing_checkout_post /api/v1/billing/checkout |
Create a Stripe Checkout session for Pro upgrade. |
| GET |
create_checkout_api_v1_billing_checkout_get /api/v1/billing/checkout |
Create a Stripe Checkout session for Pro upgrade. |
| GET |
customer_portal_api_v1_billing_portal_get /api/v1/billing/portal |
Redirect to Stripe Customer Portal to manage subscription. |
| feedback | ||
| POST |
submit_feedback_api_v1_feedback__post /api/v1/feedback/ |
Submit feedback. Requires logged-in session. |
| GET |
admin_feedback_api_v1_feedback_admin_get /api/v1/feedback/admin |
Admin page to view all feedback. Protected by admin email check. |
| admin | ||
| GET |
validate_prices_api_v1_admin_validation_prices_get /api/v1/admin/validation/prices |
Compare all active tickers against Yahoo Finance. Cached 24h. |
Bolsai — Financial Data API for Brazil pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | Free | — |
|
