BRbrapi-dev
Ações

Negociações de administradores e pessoas vinculadas

Changed on

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.

get/api/v2/stocks/insider-transactions

Request

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

Query parameters

symbolsstring required

Tickers separados por vírgula. Máximo de 20. Cada ticker identifica a empresa que apresenta o relatório.

Example:VALE3
startDatestring

Data inicial da movimentação. Padrão: 365 dias antes de endDate.

Example:2026-08-01
endDatestring

Data final da movimentação. Padrão: hoje.

Example:2026-08-31
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.

movementTypestring

Tipo de movimentação, com o texto exato do relatório.

Example:Compra à vista
allVersions'true' | 'false'

Inclui versões anteriores dos relatórios. Padrão: false. Versões anteriores podem repetir movimentações.

pageinteger

Página de cada empresa.

limitinteger

Máximo de movimentações por empresa e página.

Example:1

Response

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

requestedAtstring date-time required

Data e hora da requisição em ISO 8601.

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "results": [
    {
      "requestedSymbol": "VALE3",
      "symbol": "VALE3",
      "changed": false,
      "data": {
        "cnpj": "33592510000154",
        "companyName": "VALE S.A.",
        "disclosureLevel": "roleGroup",
        "firstReportDate": "2018-12-01",
        "latestReportDate": "2026-08-01",
        "latestFilingDate": "2026-09-10",
        "startDate": "2026-08-01",
        "endDate": "2026-08-31",
        "transactions": [
          {
            "id": "9b6d502173ac5f1e0e736a7b6eeea530592e3f7772723d1d66fdfa8a58aafecf:6",
            "reportDate": "2026-08-01",
            "filingDate": "2026-09-10",
            "version": 1,
            "transactionDate": "2026-08-04",
            "companyRelation": "company",
            "securityCompany": "VALE S.A.",
            "roleGroup": "board",
            "roleDescription": "Conselho de Administração ou Vinculado",
            "direction": "credit",
            "movementType": "Compra à vista",
            "description": null,
            "securityType": "Ações",
            "securityClass": "ON",
            "intermediary": "BTG PACTUAL CTVM S.A.",
            "quantity": "4",
            "unitPrice": "76.2900000000",
            "volume": "305.1600000000"
          }
        ],
        "pagination": {
          "page": 1,
          "limit": 1,
          "total": 5,
          "hasMore": true
        }
      }
    }
  ],
  "requestedAt": "2026-09-30T12:00:00.000Z",
  "took": 6
}

Changes