Consulta paginada de negociações em mercado secundário

Endpoint de consulta paginada que retorna as negociações de cotas em mercado secundário de uma classe de fundo. Cada registro representa a transferência de uma quantidade de cotas de um cotista vendedor para um cotista comprador, com o valor de cota praticado na negociação e a tributação retida do vendedor.

Cada negociação relaciona três aplicações financeiras:

Papel	Descrição
sold_financial_application	Aplicação do vendedor, da qual as cotas saíram. É por ela que os filtros de classe de fundo, série, investidor e depositária central são aplicados.
new_financial_application	Aplicação criada para o comprador, com financial_application_type igual a secondary_market.
original_financial_application	Aplicação que originou a posição no mercado primário. Em revendas sucessivas, a mesma aplicação original é propagada para todas as negociações da cadeia, permitindo rastrear a entrada original das cotas.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Leitura

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

/quota/fund_class/{fund_class_key}/secondary_market_trades

MÉTODO

GET

Query params

Parâmetro	Tipo	Obrigatoriedade	Descrição
page	integer	opcional	Número da página (começa em 0). Padrão: 0.
limit	integer	opcional	Quantidade de registros por página. Padrão: 50. Máximo: 500.
issuance_serie_key	string	opcional	Filtra pelas negociações da série de emissão informada.
investor_key	string	opcional	Filtra pelas negociações em que o investidor informado é o vendedor.
sold_financial_application_key	string	opcional	Filtra pela aplicação financeira de origem das cotas negociadas.
central_depositary	string	opcional	Filtra pela depositária central da aplicação de origem. Valores: cetip (cotas depositadas na B3) ou unregistered (cotas não depositadas).

Os registros são retornados em ordem cronológica de criação da negociação.

Exemplo de chamada

GET /quota/fund_class/{fund_class_key}/secondary_market_trades?page=0&limit=50&issuance_serie_key=c3d4e5f6-a7b8-9012-cdef-123456789012&central_depositary=cetip

Response

STATUS

200

Response Body

{
  "data": [
    {
      "secondary_market_trade_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "original_financial_application": {
        "financial_application_key": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "share_capital": 500000.0,
        "status": "quoted",
        "redemption_keys": [
          {
            "redemption_key": "c3d4e5f6-a7b8-9012-cdef-123456789012"
          }
        ],
        "financial_application_type": "primary_market",
        "original_number_of_quotas": 500000.0,
        "current_principal_value": 490000.0,
        "acquisition_cost": 500000.0,
        "current_number_of_quotas": 490000.0,
        "quotation_date": "2026-03-02",
        "payment_method": "b3",
        "investor_key": "d4e5f6a7-b8c9-0123-def0-234567890123",
        "issuance_serie_key": "e5f6a7b8-c9d0-1234-ef01-345678901234",
        "external_id": "ext-fa-001"
      },
      "sold_financial_application": {
        "financial_application_key": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "share_capital": 500000.0,
        "status": "quoted",
        "redemption_keys": [
          {
            "redemption_key": "c3d4e5f6-a7b8-9012-cdef-123456789012"
          }
        ],
        "financial_application_type": "primary_market",
        "original_number_of_quotas": 500000.0,
        "current_principal_value": 490000.0,
        "acquisition_cost": 500000.0,
        "current_number_of_quotas": 490000.0,
        "quotation_date": "2026-03-02",
        "payment_method": "b3",
        "investor_key": "d4e5f6a7-b8c9-0123-def0-234567890123",
        "issuance_serie_key": "e5f6a7b8-c9d0-1234-ef01-345678901234",
        "external_id": "ext-fa-001"
      },
      "new_financial_application": {
        "financial_application_key": "f6a7b8c9-d0e1-2345-f012-456789012345",
        "share_capital": 10523.45,
        "status": "quoted",
        "redemption_keys": [],
        "financial_application_type": "secondary_market",
        "original_number_of_quotas": 10000.0,
        "current_principal_value": 1.05234567,
        "acquisition_cost": 1.05234567,
        "current_number_of_quotas": 10000.0,
        "quotation_date": "2026-03-02",
        "payment_method": "b3",
        "investor_key": "a7b8c9d0-e1f2-3456-0123-567890123456",
        "issuance_serie_key": "e5f6a7b8-c9d0-1234-ef01-345678901234"
      },
      "trade_quota_value": 1.05234567,
      "number_of_quotas": 10000.0,
      "event_datetime": "2026-07-31 00:00:00",
      "taxable_yield_value": 523.45,
      "ir_value": 78.52,
      "iof_value": 0.0
    }
  ],
  "limit": 50,
  "page": 0,
  "is_last_page": true
}

Atributos da resposta

Campo	Tipo	Descrição
data	array	Lista de negociações da classe de fundo.
page	integer	Página atual.
limit	integer	Tamanho da página solicitado.
is_last_page	boolean	Indica se não há mais registros após esta página.

Objeto em data

Campo	Tipo	Descrição
secondary_market_trade_key	string	Chave única da negociação.
original_financial_application	object	Aplicação financeira que originou a posição no mercado primário.
sold_financial_application	object	Aplicação financeira do vendedor, de onde saíram as cotas.
new_financial_application	object	Aplicação financeira criada para o comprador.
trade_quota_value	number	Valor de cota praticado na negociação.
number_of_quotas	number	Quantidade de cotas negociadas.
event_datetime	string	Data e hora do evento de negociação.
taxable_yield_value	number	Rendimento tributável apurado para o vendedor na negociação. Omitido quando não apurado.
ir_value	number	Imposto de renda retido do vendedor. Omitido quando não apurado.
iof_value	number	IOF retido do vendedor. Omitido quando não apurado.

Objeto de aplicação financeira

Campo	Tipo	Descrição
financial_application_key	string	Chave única da aplicação financeira.
share_capital	number	Valor aportado na aplicação.
status	string	Situação da aplicação, por exemplo quoted, settled, redeemed.
redemption_keys	array	Chaves dos resgates associados à aplicação. Na aplicação do vendedor inclui o resgate gerado pela negociação.
financial_application_type	string	primary_market ou secondary_market.
original_number_of_quotas	number	Quantidade de cotas na criação da aplicação.
current_number_of_quotas	number	Quantidade de cotas atual.
current_principal_value	number	Valor principal atual.
acquisition_cost	number	Custo de aquisição.
quotation_date	string	Data de cotização.
payment_method	string	Forma de liquidação, por exemplo b3 ou regular.
investor_key	string	Chave do investidor titular da aplicação.
issuance_serie_key	string	Chave da série de emissão da aplicação.
external_id	string	Identificador externo, quando informado no cadastro da aplicação.

Campos opcionais são omitidos da resposta quando não houver valor.

Para consultar as aplicações financeiras em detalhe, consulte Consulta paginada de aplicações financeiras.

Erros

Status	Código	Quando acontece
400	QIT000004	O fundo não é da gestora da integração
404	QTA000002	Classe de fundo não encontrada

Erros de autenticação, permissão e host: veja Erros da API.