Dados B3 Acoes API
The Acoes API from Dados B3 — 4 operation(s) for acoes.
The Acoes API from Dados B3 — 4 operation(s) for acoes.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/dadosb3-com:dadosb3-com-acoes-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Dados B3 Acoes API
description: 'Dados fundamentalistas de companhias abertas brasileiras com metodologia 100% pública e invariantes de dado publicados. Fontes: CVM (dados abertos, ODbL) e B3 (COTAHIST fim-de-dia). Todo número carrega a conta CVM de origem; valor duvidoso carrega flag, nunca estimativa escondida.'
version: 0.1.0
tags:
- name: Acoes
paths:
/acoes/{ticker}/reapresentacoes:
get:
summary: Pagina Reapresentacoes Empresa
description: '"A companhia já reapresentou balanço? Em que anos?" — respondido no
título, com a tabela ano/conta/antes/depois e o arquivo da CVM. ABERTA.
Ver dados_b3/pagina_reapresentacoes_empresa.py.'
operationId: pagina_reapresentacoes_empresa_acoes__ticker__reapresentacoes_get
parameters:
- name: ticker
in: path
required: true
schema:
type: string
title: Ticker
- name: lang
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Lang
- name: accept-language
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Accept-Language
responses:
'200':
description: Successful Response
content:
text/html:
schema:
type: string
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Acoes
/acoes/{ticker}/{tema}:
get:
summary: Resposta Da Companhia
description: '"Quanto pagou de dividendos?", "o lucro cresceu?", "a dívida subiu?" — a resposta numa frase, a tabela e o
caminho para conferir (17/10/2026). `.md` = texto simples para IA. Ver dados_b3/pagina_respostas.py.'
operationId: resposta_da_companhia_acoes__ticker___tema__get
parameters:
- name: ticker
in: path
required: true
schema:
type: string
title: Ticker
- name: tema
in: path
required: true
schema:
type: string
title: Tema
- name: lang
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Lang
- name: accept-language
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Accept-Language
responses:
'200':
description: Successful Response
content:
text/html:
schema:
type: string
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Acoes
/acoes/{ticker}:
get:
summary: Pagina Empresa
description: 'A pagina publica de uma companhia. ABERTA — e a porta de entrada.
`?ano=2025` recorta a tabela de proventos; `?ano=todos` mostra tudo.
`?janela=1a` escolhe a janela do gráfico de cotação (1m…max).
`?em=AAAA-MM-DD` (31/10/2026): a MÁQUINA DO TEMPO — a página como o mercado a via na data, sem preço
(licença de cotação pendente). Canonical na página sem data e noindex. Ver `dados_b3/maquina_do_tempo.py`.
Código antigo (EMBR3) redireciona 301 para o atual, com `?de=`.
Monta numa thread, pela fila própria da ficha (ver `_limitador_da_ficha`).'
operationId: pagina_empresa_acoes__ticker__get
parameters:
- name: ticker
in: path
required: true
schema:
type: string
title: Ticker
- name: lang
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Lang
- name: ano
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Ano
- name: janela
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Janela
- name: de
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: De
- name: em
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Em
- name: accept-language
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Accept-Language
responses:
'200':
description: Successful Response
content:
text/html:
schema:
type: string
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Acoes
/acoes:
get:
summary: Hub Acoes
description: 'Vertical de ações: rankings, screener, setores, reapresentações.'
operationId: hub_acoes_acoes_get
parameters:
- name: lang
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Lang
- name: accept-language
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Accept-Language
responses:
'200':
description: Successful Response
content:
text/html:
schema:
type: string
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Acoes
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
ChaveApiNaUrl:
type: apiKey
in: query
name: chave
description: Alternativa ao cabeçalho para clientes que só abrem URL (navegação de IA). Fica no histórico e nos logs de quem a usa.
ChaveApi:
type: apiKey
in: header
name: X-API-Key
description: 'Chave grátis (200 consultas/dia) ou Pro em /assinar. Abertos sem chave (limite por IP): fatos, indicadores, múltiplos e dividendos de qualquer ticker, ficha e ranking de FII. WEGE3, MXRF11, /hoje, /saude e a metodologia são abertos. Exigem chave: as_of, versões, preços, screener, /dump.'