Listar Movimentações

Lista as movimentações (compras, vendas, transferências e impostos) de um investimento específico.

Endpoint

Método e URL:

GET /v1/items/:itemId/investments/:investmentId/transactions

Parâmetros da URL:

• itemId (string, obrigatório): Identificador único do item
• investmentId (UUID v7, obrigatório): Identificador único do investimento

Campos da Movimentação

• id: Identificador único da movimentação
• type: Tipo da movimentação
  • BUY: Compra/aplicação
  • SELL: Venda/resgate
  • TRANSFER: Transferência
  • TAX: Cobrança de imposto
  • INTEREST_ACCRUAL: Rendimento / Juros
  • MATURITY: Vencimento
  • MARK_TO_MARKET: Marcação a Mercado
  • COME_COTAS: Come-Cotas
• quantity: Quantidade de cotas movimentadas. Pode ser null
• unitValue: Valor unitário da cota. Pode ser null
• grossValue: Valor bruto da movimentação (com impostos). Pode ser null
• netValue: Valor líquido da movimentação (descontados taxas e impostos). Pode ser null
• placedAt: Data e hora em que a movimentação foi solicitada
• confirmedAt: Data e hora em que a movimentação foi confirmada. Pode ser null
• updatedAt: Data da última atualização
• createdAt: Data de criação

Resposta

Resposta de sucesso (200):

{
  "status": "success",
  "data": [
    {
      "id": "uuid",
      "type": "BUY | SELL | TRANSFER | TAX | INTEREST_ACCRUAL | MATURITY | MARK_TO_MARKET | COME_COTAS",
      "quantity": "string | null",
      "unitValue": "string | null",
      "grossValue": "string | null",
      "netValue": "string | null",
      "placedAt": "timestamp",
      "confirmedAt": "timestamp | null",
      "updatedAt": "timestamp",
      "createdAt": "timestamp"
    }
  ]
}

Resposta de erro (404):

{
  "status": "error",
  "message": "Investment not found."
}

Observações

• Diferente dos outros endpoints, o campo data é diretamente o array de movimentações, sem um objeto envoltório.
• Valores monetários são retornados como string formatada na moeda do investimento.