Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API 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.
openapi: 3.2.0
info:
title: Dados B3 Fundos 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: Fundos
paths:
/fundos:
get:
summary: Fundos Pagina
description: 'Fundos de investimento da CVM (Informe Diário, ODbL): busca por nome ou CNPJ, os maiores por PL e quem mais
captou ou perdeu no mês de referência. ABERTA.'
operationId: fundos_pagina_fundos_get
parameters:
- name: q
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Q
- 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:
- Fundos
/fundos/informe:
get:
summary: Fundos Informe
description: 'Cota, PL, cotistas e captação dos fundos de investimento (Informe Diário da CVM, ODbL), em JSON ou CSV
(`formato=csv`). Sem parâmetro: os maiores por PL, os que mais captaram e os que mais perderam no mês de
referência (o mais novo já fechado), `limite` por lista (1 a 500, padrão 20; no CSV vale a lista de `ordem` =
pl|entrada|saida). `cnpj` (14 dígitos, com ou sem pontuação): a série mensal de UM fundo, 13 meses. `busca`: fundos
pelo nome (sem acento e sem caixa) ou pelo começo do CNPJ. Captação líquida e variação da cota no mês são contas
nossas. ABERTA, sem chave. Toda resposta leva a fonte, a licença e a `citacao`.'
operationId: fundos_informe_fundos_informe_get
parameters:
- name: cnpj
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Cnpj
- name: busca
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Busca
- name: ordem
in: query
required: false
schema:
type: string
default: pl
title: Ordem
- name: limite
in: query
required: false
schema:
type: integer
default: 20
title: Limite
- name: formato
in: query
required: false
schema:
type: string
default: json
title: Formato
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Fundos
/fundos/{cnpj}:
get:
summary: Fundo Pagina
description: 'Um fundo de investimento (CNPJ da classe ou do fundo, 14 dígitos): cadastro e 13 meses de cota, PL, cotistas e
captação, do Informe Diário da CVM. 404 se o fundo não tem informe. Antes da primeira coleta (base sem a tabela):
200 com o aviso de dados em coleta, `noindex` e sem número — a mesma regra da /fundos e das páginas por ativo
(TR34 exige que a página pública com parâmetro abra com qualquer Accept). ABERTA.'
operationId: fundo_pagina_fundos__cnpj__get
parameters:
- name: cnpj
in: path
required: true
schema:
type: string
title: Cnpj
- 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:
- Fundos
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.'