Fundos

Carteira de um fundo

Posições da carteira aberta (CDA) de um fundo numa competência: ativo, emissor, quantidade e valor de mercado.

GEThttps://api.fintay.com.br/v1/funds/{cnpj}/portfolio

Autorização

X-API-Keystringheaderobrigatório

Chave de API criada em API Keys. Veja Chaves e limites.

Parâmetros de rota

cnpjstringobrigatório

CNPJ do fundo ou da classe.

Parâmetros de consulta

competencestring · dateobrigatório

Mês da carteira, no primeiro dia (AAAA-MM-01). As carteiras saem com cerca de 90 dias de defasagem.

limitintegerpadrão: 100mín. 1 · máx. 1000

Máximo de posições.

offsetintegerpadrão: 0mín. 0

Posições a pular.

Resposta

Envelope { success, data, meta }. Campos de data.items[]:

idinteger

Exemplo: 1277

class_idstring

Exemplo: 6138ebe8-8a03-4e32-bd79-4423994e9ce3

competenciastring

Exemplo: 2026-08-01

blocostring

Exemplo: 1

tp_aplicstring

Exemplo: Operações Compromissadas

tp_ativostring

Exemplo: Título público federal

emissor_cnpjnull

emissor_nomenull

isinstring

Exemplo: BRSTNCLTN897

codigo_ativonull

vl_merc_pos_finalnumber

Exemplo: 3727291209.71

pct_pnanull

archive_idstring

Exemplo: 779e7659-8c47-4ce6-83ed-9b7b17355cbd

source_filestring

Exemplo: cda_fi_BLC_1_202608.csv

row_numberinteger

Exemplo: 4114

GETCarteira de um fundo

curl "https://api.fintay.com.br/v1/funds/08771962000156/portfolio?competence=2026-08-01&limit=3" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "items": [
      {
        "id": 1277,
        "class_id": "6138ebe8-8a03-4e32-bd79-4423994e9ce3",
        "competencia": "2026-08-01",
        "bloco": "1",
        "tp_aplic": "Operações Compromissadas",
        "tp_ativo": "Título público federal",
        "emissor_cnpj": null,
        "emissor_nome": null,
        "isin": "BRSTNCLTN897",
        "codigo_ativo": null,
        "vl_merc_pos_final": 3727291209.71,
        "pct_pna": null,
        "archive_id": "779e7659-8c47-4ce6-83ed-9b7b17355cbd",
        "source_file": "cda_fi_BLC_1_202608.csv",
        "row_number": 4114
      },
      {
        "id": 1278,
        "class_id": "6138ebe8-8a03-4e32-bd79-4423994e9ce3",
        "competencia": "2026-08-01",
        "bloco": "1",
        "tp_aplic": "Operações Compromissadas",
        "tp_ativo": "Título público federal",
        "emissor_cnpj": null,
        "emissor_nome": null,
        "isin": "BRSTNCLTN806",
        "codigo_ativo": null,
        "vl_merc_pos_final": 6163960615.8,
        "pct_pna": null,
        "archive_id": "779e7659-8c47-4ce6-83ed-9b7b17355cbd",
        "source_file": "cda_fi_BLC_1_202608.csv",
        "row_number": 4115
      },
      {
        "id": 1279,
        "class_id": "6138ebe8-8a03-4e32-bd79-4423994e9ce3",
        "competencia": "2026-08-01",
        "bloco": "1",
        "tp_aplic": "Operações Compromissadas",
        "tp_ativo": "Título público federal",
        "emissor_cnpj": null,
        "emissor_nome": null,
        "isin": "BRSTNCLTN8A7",
        "codigo_ativo": null,
        "vl_merc_pos_final": 1054913149.23,
        "pct_pna": null,
        "archive_id": "779e7659-8c47-4ce6-83ed-9b7b17355cbd",
        "source_file": "cda_fi_BLC_1_202608.csv",
        "row_number": 4116
      }
    ],
    "has_more": true,
    "offset": 0,
    "note": "Posições públicas; posições confidenciais não são estimadas."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}