DataBolsa

API · SDK · CLI · MCP

A mesma API que serve o site — aberta pro seu código.

Contrato OpenAPI 3.1, SDK TypeScript tipado, CLI e servidor MCP. Toda resposta carrega lineage — seu agente cita a fonte de cada número. Nenhuma caixa-preta entre o agente e o dado oficial.

Pegar uma API keyLer a referência →
◇ open source · Apache-2.0 · github.com/databolsahq/databolsa ↗
# todo número volta com a sua linhagem
curl https://api.databolsa.com/v1/stocks/PETR4 \
-H "Authorization: Bearer db_live_***"

31

tools MCP

4

superfícies · REST · SDK · CLI · MCP

100%

respostas com lineage

Apache-2.0

licença · self-host

Um contrato, quatro superfícies

Os mesmos endpoints, do curl ao agente.

Tudo é gerado do contrato OpenAPI no startup — então SDK, CLI e MCP nunca ficam atrás da API. Escolha a superfície; a linhagem vem junto em todas.

REST

API HTTP

Contrato OpenAPI 3.1 design-first. Paginação por cursor, erros RFC 9457, unidades documentadas.

GET /v1/stocks/PETR4
TypeScript

SDK tipado

A mesma interface que serve o site. Tipos gerados do contrato; o objeto lineage em cada resposta.

npm i @databolsa/sdk
Terminal

CLI

Um comando por operação. Saída legível pra humano, --json pra pipelines. Mesma linhagem da API.

npx @databolsa/cli --list
Agentes

Servidor MCP

31 tools read-only geradas do contrato. O padrão aberto que liga o seu agente à fonte oficial.

npx @databolsa/mcp

Servidor MCP

Conecte seu agente em 30 segundos.

MCP (Model Context Protocol) é o padrão aberto que liga agentes a fontes de dados. O servidor da DataBolsa expõe cada endpoint como uma tool tipada — ações, FIIs, índices, renda fixa, macro, screeners, BDRs, opções, cripto e busca.

// claude_desktop_config.json
{
"mcpServers": {
"databolsa": {
"command": "npx",
"args": ["-y", "@databolsa/mcp"]
}
}
}

✓ 31 tools · stdio ou HTTP · sem chave no modo self-hosted

✓getStock(PETR4)→ resposta com fonte
// agente conectado via MCP — cada número volta com lineage. experimente:
exemplos

Sem caixa-preta

A linhagem é o contrato.

Cada métrica responde de onde veio: fonte, a referência (conta CVM, série do BCB, arquivo da B3) e a URL do dado aberto. Se não dá pra auditar, a gente não publica. O agente cita a origem; você confere a citação.

ver fonte: ITR 1T26· conta 3.11 (lucro)ver fonte: dados.cvm.gov.br· dado aberto
GET /v1/stocks/PETR4 · indicators.pl
{
"name": "pl",
"label": "P/L",
"value": 4.6,
"unit": "ratio",
"ttm": true,
"lineage": {
"source": "cvm_dfp_itr",
"reference": "CD_CONTA 3.11 · ITR 1T2026 · consolidado",
"url": "https://dados.cvm.gov.br/…"
}
}

Dados abertos

Só fontes oficiais — e sempre rastreáveis.

O modo hospedado serve apenas fontes abertas. Extratores, contrato OpenAPI e as fórmulas dos indicadores são públicos: rode self-hosted e busque os seus próprios dados quando precisar.

CVMB3BCBTesouro DiretoIBGEFREDFNETBinance

modo hospedado serve só fontes abertas · B3 e Binance são fetch-your-own no self-host (você responde pelos termos de redistribuição).

Aberto de ponta a ponta

Apache-2.0. Extratores, contrato e fórmulas — públicos.

Ingestão, lake Parquet, transformações dbt/DuckDB, marts, Postgres de serving, REST API, SDK, CLI e MCP. Tudo no mesmo repositório.

◇ github.com/databolsahq/databolsa ↗dê uma estrela · faça um fork · self-host