# Bolsix

> Bolsix provides structured Brazilian market data from B3, CVM, and BCB to AI agents through MCP and to applications through REST.

Try it without a key: `curl "https://api.bolsix.io/v1/stocks/quote?symbols=PETR4,VALE3"` (demo tickers PETR4, VALE3, ITUB4, HGLG11, BOVA11 on quote, prices, fundamentals and dividends; 100 requests a day per IP).

## Start here

- [Documentation](https://bolsix.io/docs): Product and integration overview
- [Quickstart](https://bolsix.io/docs/quickstart): First MCP connection or REST request
- [Authentication](https://bolsix.io/docs/authentication): OAuth and API-key authentication
- [MCP server](https://bolsix.io/docs/mcp): Hosted and local client setup
- [REST API](https://bolsix.io/docs/rest-api): API conventions and examples

## Reference

- [REST endpoints](https://bolsix.io/docs/api-reference): Complete public v1 endpoint catalog
- [MCP tools](https://bolsix.io/docs/mcp-tools): Complete agent tool catalog
- [Methodology](https://bolsix.io/docs/methodology): CVM account behind every statement field and the formula behind every ratio
- [OpenAPI](https://api.bolsix.io/openapi.json): Canonical machine-readable REST schema
- [Full LLM context](https://bolsix.io/llms-full.txt): Integration contract in one text file

## Important semantics

- B3 symbols are used without a suffix: PETR4, VALE3, HGLG11.
- Dividends and JCP are distinct. For Brazilian individuals, JCP has 15% withholding; dividends are currently tax-free.
- Ratio filters use decimals: 0.15 means 15%.
- Preserve CVM doc_url and statement provenance when citing research.