FIDCs.com.brDevelopers

Páginas

Indústria e históricoAPI REST & PlaygroundGuia MCP & AgentesReferência OpenAPIChangelog

Categorias

Contrato OpenAPIAçõesCompanhiasCrédito privadoSéries diáriasInformes estruturadosTítulos públicosMacroeconomia e benchmarksIndústriaContratoIdentidadeCadastroDocumentosVisão geralCarteiraCotas e rentabilidadeDemonstrativoInvestidoresCoberturaRaio-X FIC-FIDCOperaçãoPlayground← Testar no Guia REST
Chave apenas na memória
FIDCs.com.brDevelopers
Todas as operações de Investidores

Contrato OpenAPI · Investidores

Listar fundos investidores

GET
/v1/classes/{class_id}/investidores

Use month para uma competência ou from/to para o histórico de fundos identificados em carteiras públicas. Não representa todos os cotistas.

Custo: 3 créditos.

Autorização

FIDCs API key
AuthorizationBearer <token>

Envie Authorization: Bearer fidc_live_.... No playground, informe somente a chave completa; a interface monta o header sem persistir o segredo.

In: header

Parâmetros da rota

class_id*Class Id

UUID persistente da classe, obtido em /v1/fundos/{fund_id}/classes ou /v1/resolve.

Parâmetros da consulta

month?|

Competência exata no formato YYYY-MM.

from?|

Primeira competência do intervalo, inclusive, no formato YYYY-MM.

to?|

Última competência do intervalo, inclusive, no formato YYYY-MM.

Corpo da resposta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/classes/b2e1079e-53ab-4306-acc6-905c37ed1021/investidores?month=2026-07&from=2026-01&to=2026-07"
{  "data": [    {      "month": "string",      "previous_month": "string",      "investor_cnpj": "string",      "investor_name": "string",      "investor_manager": "string",      "investor_fund_type": "string",      "investor_fund_type_label": "string",      "position_brl": 0,      "previous_position_brl": 0,      "position_variation_brl": 0,      "position_variation_pct": 0,      "position_share_of_investor_nav_pct": 0,      "position_share_of_invested_nav_pct": 0,      "investor_nav_brl": 0,      "invested_nav_brl": 0,      "acquisitions_brl": 0,      "sales_brl": 0,      "movement": "string"    }  ],  "meta": {    "request_id": "string",    "data_release": "string",    "as_of": "string",    "row_count": 0,    "sources": [      {        "provider": "string",        "dataset": "string"      }    ],    "field_sources": {      "property1": "string",      "property2": "string"    },    "receivables_definitions": {},    "receivables_by_month": [      {}    ]  }}