Consulta de Posição do Investidor

Este endpoint permite consultar a posição consolidada de um investidor, retornando informações sobre suas participações em securities.

---

Request

ENDPOINT

/security/investor/INVESTOR-KEY

MÉTODO

GET

Path Params

Campo	Tipo	Descrição	Caracteres
INVESTOR-KEY	string	Chave única do investidor (UUID v4).	36

---

Response

STATUS

200

Response Body

{
    "investor_key": "a1a75b66-6f7e-4bcc-9ff5-6f8adf7cae09",
    "investor_name": "Ultimate Cascade",
    "investor_document_number": "31.424.651/0001-32",
    "total_current_amount": 100000.0,
    "investment_list": [
        {
            "current_unit_price": 1.0,
            "current_quantity": 100000,
            "security_key": "42bd7161-5ec1-4f64-ac0c-861d93ffb4c2",
            "contract_number": "0000000027",
            "investment_key": "4b705afb-18cb-4fe5-922a-5eab71c2b558",
            "current_amount": 100000.0
        }
    ]
}

---

Response Body Params

Campo	Tipo	Descrição
investor_key	string	Chave única do investidor.
investor_name	string	Nome do investidor.
investor_document_number	string	Número do documento do investidor (CNPJ).
total_current_amount	number	Valor total consolidado do investidor.
investment_list	array	Lista das participações do investidor em securities. Objeto investment

Objeto investment

Campo	Tipo	Descrição
current_unit_price	number	Preço unitário atual da security.
current_quantity	integer	Quantidade atual da security do investidor.
security_key	string	Chave única da security associada.
contract_number	string	Número do contrato da security.
investment_key	string	Chave única do investimento do investidor.
current_amount	number	Valor atual da participação do investidor.