Cole no ChatGPT/Claude e peça para resumir/gerar SDK.
Transações de insiders
GET
/companies/[companyIdentifier]/insider-transactions
Retorna uma lista de relatórios mensais de transações e posições de insiders (CVM Resolução 44) associados à empresa.
Como usar
- Para listar todos os relatórios disponíveis: chame o endpoint apenas com
[companyIdentifier]. - Para buscar um mês específico: use
month=YYYY-MM. - Para reduzir o payload: filtre por
aggregation,group_ide/outrade. - Para paginação incremental: use
publish_datee/ouretrieval_datecomo “cursor” (maior que a data informada).
Parâmetros de requisição
| Parâmetro | Local | Descrição | Obrigatório |
|---|---|---|---|
[companyIdentifier] | URL | Identificador da empresa. | Obrigatório |
aggregation | Query | Tipo de agregação (INDIVIDUAL/CONSOLIDATED). | Opcional |
month | Query | Mês do relatório. Formato: YYYY-MM. | Opcional |
trade | Query | Filtra relatórios em que houve negociação (true/false). | Opcional |
group_id | Query | Filtra pelo ID do grupo (ver tabela abaixo). | Opcional |
publish_date | Query | Retorna apenas relatórios com publish_date maior que o valor (ISO 8601). | Opcional |
retrieval_date | Query | Retorna apenas relatórios com retrieval_date maior que o valor (ISO 8601). | Opcional |
Conceitos
Tipo de agregação (aggregation)
Os relatórios podem vir em dois modelos:
- INDIVIDUAL (Inciso I): visão societária da companhia e partes relacionadas (tesouraria, controladas e coligadas).
- CONSOLIDATED (Inciso II): visão por órgão estatutário (conselho, diretoria, conselho fiscal, comitês).
Grupos (group_id)
- 0: Não definido
- 1: Controlador
- 2: Conselho de Administração
- 3: Diretoria
- 4: Conselho Fiscal
- 5: Órgão Estatuário
- 6: Órgãos Técnicos ou Consultivos
- 7: Tesouraria
- 8: Controlada
- 9: Coligada
Respostas
| Código | Descrição |
|---|---|
| 200 | Retorna os relatórios de insiders. |
| 404 | Empresa não encontrada. |
| 400 | Parâmetros ausentes ou inválidos. |
| 401 | Não autorizado. |
Formato da resposta
A resposta é uma lista de objetos com os campos abaixo:
| Campo | Tipo | Descrição |
|---|---|---|
title | string | Título do formulário/report mensal. |
aggregation | string | Tipo de agregação (INDIVIDUAL ou CONSOLIDATED). |
description | string | Descrição textual do tipo de formulário. |
month | string (YYYY-MM) | Mês de referência do relatório. |
reference_date | string (ISO 8601) | Data de referência do relatório mensal. |
publish_date | string (ISO 8601) | Data de publicação do relatório na CVM. |
retrieval_date | string (ISO 8601) | Data/hora de coleta do relatório pela Partnr. |
trade | boolean | Indica se houve negociação no período (true/false). |
group | object | Grupo societário/estatutário associado ao relatório. |
parent_company_name | string | Nome da controladora, quando aplicável. |
subsidiary_company_name | string | null | Nome da controlada/coligada, quando aplicável. |
initial_balance | array | Posição inicial do mês por tipo/subtipo de ativo. |
trades | array | Negociações ocorridas no mês (quando houver). |
final_balance | array | Posição final do mês por tipo/subtipo de ativo. |
source | object | Metadados e links da fonte oficial (CVM). |
Estrutura de group
| Campo | Tipo | Descrição |
|---|---|---|
id | integer | ID do grupo (group_id). |
name | string | Nome do grupo (ex.: Controlador, Tesouraria, Diretoria). |
entity_id | string | CNPJ/identificador da entidade, quando aplicável. |
entity_name | string | Nome da entidade, quando aplicável. |
Estrutura de initial_balance[] e final_balance[]
| Campo | Tipo | Descrição |
|---|---|---|
type | string | Tipo do ativo/posição (ex.: Ações, Opção de Compra, Outros). |
subtype | string | Subtipo da posição (ex.: ON, OPCAO DE COMPRA). |
quantity | number | Quantidade na posição (inicial ou final). |
Estrutura de trades[]
| Campo | Tipo | Descrição |
|---|---|---|
type | string | Tipo do ativo negociado. |
subtype | string | Subtipo do ativo negociado. |
broker | string | Intermediário/corretora da operação. |
trade_type | string | Tipo de negociação (compra, venda, outras saídas, derivativos etc.). |
day | integer | Dia do mês em que ocorreu a negociação. |
quantity | number | Quantidade negociada. |
price | number | Preço unitário da negociação, quando aplicável. |
volume | number | Volume financeiro da negociação, quando aplicável. |
Exemplo
{
"title": "Formulário Consolidado",
"aggregation": "CONSOLIDATED",
"description": "Negociação de Administradores e Pessoas Ligadas",
"month": "2025-12",
"reference_date": "2025-12-01T03:00:00.000Z",
"publish_date": "2026-01-09T23:10:00.000Z",
"retrieval_date": "2026-01-11T17:40:34.897Z",
"trade": true,
"group": {
"id": 1,
"name": "Controlador",
"entity_id": null,
"entity_name": null
},
"parent_company_name": null,
"subsidiary_company_name": null,
"initial_balance": [
{
"type": "Ações",
"subtype": "ON",
"quantity": 662350688
},
{
"type": "Opção de Compra",
"subtype": "ON",
"quantity": -500000
},
{
"type": "Opção de Compra",
"subtype": "OPCAO DE COMPRA",
"quantity": 500000
}
],
"trades": [
{
"type": "Ações",
"subtype": "ON",
"broker": "Agora Ctvm S/A",
"trade_type": "OUTRAS SAÍDAS",
"day": 3,
"quantity": 14986800,
"price": 19.2,
"volume": 287746560
},
{
"type": "Outros",
"subtype": "DERIVATIVO COM LIQUIDACAO FINANCEIRA",
"broker": "J.P. Morgan Ccvm S/A",
"trade_type": "DERIVATIV OS COM LIQUIDAÇÃ O FINANCEIR A",
"day": 3,
"quantity": 14986800,
"price": 19.2,
"volume": 287746560
}
],
"final_balance": [
{
"type": "Ações",
"subtype": "ON",
"quantity": 647363888
},
{
"type": "Opção de Compra",
"subtype": "ON",
"quantity": -500000
},
{
"type": "Opção de Compra",
"subtype": "OPCAO DE COMPRA",
"quantity": 500000
},
{
"type": "Outros",
"subtype": "DERIVATIVO COM LIQUIDACAO FINANCEIRA",
"quantity": 14986800
}
],
"source": {
"visualization_url": "https://www.rad.cvm.gov.br/ENET/frmExibirArquivoIPEExterno.aspx?NumeroProtocoloEntrega=1466036",
"download_url": "https://www.rad.cvm.gov.br/ENET/frmDownloadDocumento.aspx?Tela=ext&numSequencia=990742&numVersao=1&numProtocolo=1466036&descTipo=IPE&CodigoInstituicao=1",
"published_at": "2026-01-09T23:10:00.000Z",
"retrieved_at": "2026-01-11T17:40:34.897Z"
}
},
{
"title": "Formulário Individual",
"aggregation": "INDIVIDUAL",
"description": "Negociação de Valores Mobiliários pela própria companhia, suas controladas e coligadas",
"month": "2025-12",
"reference_date": "2025-12-01T03:00:00.000Z",
"publish_date": "2026-01-09T23:10:00.000Z",
"retrieval_date": "2026-01-11T17:40:39.078Z",
"trade": true,
"group": {
"id": 7,
"name": "Tesouraria",
"entity_id": "03853896000140",
"entity_name": "MARFRIG GLOBAL FOODS SA"
},
"parent_company_name": null,
"subsidiary_company_name": null,
"initial_balance": [
{
"type": "Ações",
"subtype": "ON",
"quantity": 13795044
},
{
"type": "Outros",
"subtype": "DERIVATIVO COM LIQUIDACAO FINANCEIRA",
"quantity": 32083900
}
],
"trades": [
{
"type": "Ações",
"subtype": "ON",
"broker": "Banco Safra S/A",
"trade_type": "Compra à termo",
"day": 3,
"quantity": 2147400,
"price": 19.21,
"volume": 41251554
},
{
"type": "Ações",
"subtype": "ON",
"broker": "Banco Safra S/A",
"trade_type": "Compra à vista",
"day": 4,
"quantity": 1843500,
"price": 19.99911,
"volume": 36868354
},
{
"type": "Ações",
"subtype": "ON",
"broker": "Banco Safra S/A",
"trade_type": "Compra à vista",
"day": 8,
"quantity": 759400,
"price": 19.55047,
"volume": 14846625
},
{
"type": "Ações",
"subtype": "ON",
"broker": "Banco Safra S/A",
"trade_type": "Compra à vista",
"day": 9,
"quantity": 2099800,
"price": 19.46653,
"volume": 40875816
},
{
"type": "Ações",
"subtype": "ON",
"broker": "Banco Safra S/A",
"trade_type": "Compra à vista",
"day": 11,
"quantity": 1550000,
"price": 19.65,
"volume": 30457500
},
{
"type": "Ações",
"subtype": "ON",
"broker": "Banco Safra S/A",
"trade_type": "Compra à vista",
"day": 12,
"quantity": 408800,
"price": 19.8406,
"volume": 8110836
},
{
"type": "Ações",
"subtype": "ON",
"broker": "Banco Safra S/A",
"trade_type": "Compra à vista",
"day": 16,
"quantity": 1535400,
"price": 19.55022,
"volume": 30017415
},
{
"type": "Ações",
"subtype": "ON",
"broker": "Banco Safra S/A",
"trade_type": "Compra à vista",
"day": 17,
"quantity": 300000,
"price": 19.55,
"volume": 5865000
},
{
"type": "Ações",
"subtype": "ON",
"broker": "Banco Safra S/A",
"trade_type": "Compra à vista",
"day": 22,
"quantity": 856200,
"price": 19.25831,
"volume": 16488966
},
{
"type": "Ações",
"subtype": "ON",
"broker": "Banco Safra S/A",
"trade_type": "Compra à vista",
"day": 19,
"quantity": 800000,
"price": 19.54,
"volume": 15632000
},
{
"type": "Ações",
"subtype": "ON",
"broker": "Banco Safra S/A",
"trade_type": "Compra à vista",
"day": 18,
"quantity": 586100,
"price": 19.53084,
"volume": 11447028
},
{
"type": "Ações",
"subtype": "ON",
"broker": "Banco Safra S/A",
"trade_type": "Compra à vista",
"day": 15,
"quantity": 1094800,
"price": 20.01089,
"volume": 21907927
},
{
"type": "Ações",
"subtype": "ON",
"broker": "Banco Safra S/A",
"trade_type": "Compra à vista",
"day": 30,
"quantity": 1074900,
"price": 19.9801,
"volume": 21476609.49
}
],
"final_balance": [
{
"type": "Ações",
"subtype": "ON",
"quantity": 28851344
}
],
"source": {
"visualization_url": "https://www.rad.cvm.gov.br/ENET/frmExibirArquivoIPEExterno.aspx?NumeroProtocoloEntrega=1466035",
"download_url": "https://www.rad.cvm.gov.br/ENET/frmDownloadDocumento.aspx?Tela=ext&numSequencia=990741&numVersao=1&numProtocolo=1466035&descTipo=IPE&CodigoInstituicao=1",
"published_at": "2026-01-09T23:10:00.000Z",
"retrieved_at": "2026-01-11T17:40:39.078Z"
}
},