---
title: "Negociações de administradores e pessoas vinculadas"
method: GET
path: "/api/v2/stocks/insider-transactions"
tags: ["Ações"]
---

# Negociações de administradores e pessoas vinculadas

`GET /api/v2/stocks/insider-transactions`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/stocks/insider-transactions`
- Auth: HTTP bearer

Movimentações de valores mobiliários por administradores, controladores e pessoas vinculadas, por empresa e período. Os relatórios são mensais. A atualização ocorre semanalmente.

O ticker identifica a empresa do relatório. PETR3 e PETR4 retornam os mesmos dados. Os registros agrupam pessoas por cargo, sem identificar cada pessoa ou o ticker negociado.

`direction` indica entrada ou saída da posição, inclusive transferências. Use `movementType` para identificar compras e vendas.

A resposta traz as movimentações mais recentes primeiro e a última versão de cada relatório. Use `allVersions=true` para incluir versões anteriores. Não some essas versões, pois elas podem repetir movimentações. Saldos iniciais não entram na lista.

Plano Pro. PETR4, MGLU3, VALE3 e ITUB4 permitem testes gratuitos, sem token.

## Query parameters

- `symbols` string, required: Tickers separados por vírgula. Máximo de 20. Cada ticker identifica a empresa que apresenta o relatório.
- `startDate` string: Data inicial da movimentação. Padrão: 365 dias antes de endDate.
- `endDate` string: Data final da movimentação. Padrão: hoje.
- `companyRelation` 'company' | 'parent' | 'subsidiary' | 'all': Empresa que emite o valor mobiliário: a própria empresa, sua controladora ou sua controlada.
- `direction` 'credit' | 'debit': Entrada ou saída da posição. Inclui transferências e outras movimentações.
- `roleGroup` 'controller' | 'board' | 'director' | 'fiscalCouncil' | 'statutoryBody': Grupo de cargos. Cada grupo inclui pessoas vinculadas.
- `movementType` string: Tipo de movimentação, com o texto exato do relatório.
- `allVersions` 'true' | 'false': Inclui versões anteriores dos relatórios. Padrão: false. Versões anteriores podem repetir movimentações.
- `page` integer: Página de cada empresa.
- `limit` integer: Máximo de movimentações por empresa e página.

## Response `200`

Movimentações por empresa, com paginação independente.

- InsiderTransactionResponse
  - `results` InsiderTransactionResult[], required
    - `requestedSymbol` string, required
    - `symbol` string, required
    - `changed` boolean, required
    - `data` object, required
      - `cnpj` string, required
      - `companyName` string, nullable, required
      - `disclosureLevel` 'roleGroup', required: Movimentações agrupadas por cargo. Os dados não identificam cada pessoa.
      - `firstReportDate` string, nullable, required: Primeiro mês de relatório disponível para a empresa. Pode haver meses sem dados.
      - `latestReportDate` string, nullable, required: Último mês de relatório disponível para a empresa.
      - `latestFilingDate` string, nullable, required: Data de apresentação mais recente. Uma correção pode se referir a um mês anterior.
      - `startDate` string, required
      - `endDate` string, required
      - `transactions` InsiderTransaction[], required: Movimentações que correspondem aos filtros. Uma lista vazia não indica posição igual a zero.
        - `id` string, required: Identificador da movimentação nesta versão do relatório.
        - `reportDate` string, required: Primeiro dia do mês de referência. Não é a data da movimentação.
        - `filingDate` string, required: Data de apresentação do relatório.
        - `version` integer, required: Versão do relatório. Uma correção substitui a versão anterior.
        - `transactionDate` string, nullable, required: Data da movimentação em YYYY-MM-DD.
        - `companyRelation` 'company' | 'parent' | 'subsidiary', required
        - `securityCompany` string, required: Nome da empresa que emite o valor mobiliário.
        - `roleGroup` 'controller' | 'board' | 'director' | 'fiscalCouncil' | 'statutoryBody', nullable, required
        - `roleDescription` string, nullable, required
        - `direction` 'credit' | 'debit', required
        - `movementType` string, required
        - `description` string, nullable, required
        - `securityType` string, required
        - `securityClass` string, nullable, required
        - `intermediary` string, nullable, required
        - `quantity` string, nullable, required: Quantidade inteira exata. Pode ser negativa.
        - `unitPrice` string, nullable, required: Valor decimal exato em texto, sem ajuste por desdobramentos. null indica valor ausente.
        - `volume` string, nullable, required: Valor decimal exato em texto, sem ajuste por desdobramentos. null indica valor ausente.
      - `pagination` object, required
        - `page` integer, required
        - `limit` integer, required
        - `total` integer, required
        - `hasMore` boolean, required
  - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601.
  - `took` integer, required: Tempo de processamento, em milissegundos.

## Other responses

- `400`: Requisição inválida. Confira os parâmetros.
- `401`: Token ausente ou inválido.
- `403`: O plano não inclui este recurso ou parâmetro.
- `404`: Nenhum dado encontrado para o pedido.
- `429`: Limite de requisições excedido.
- `500`: Erro interno do servidor.
- `503`: Serviço temporariamente indisponível. Tente de novo em alguns minutos.

## Changes

- **2026-10-16** `62eafb05acb0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/stocks/insider-transactions/get.md)

---

[API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)