跳到主要内容

查询投资人持仓

此端点允许查询投资人的综合持仓，返回其 security 持有信息。

Request​

ENDPOINT
/security/investor/INVESTOR-KEY
MÉTODO
GET

Path Params​

字段类型描述字符数
INVESTOR-KEYstring投资人的唯一键（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​

字段类型描述
investor_keystring投资人的唯一键。
investor_namestring投资人名称。
investor_document_numberstring投资人证件号码（CNPJ）。
total_current_amountnumber投资人综合总金额。
investment_listarray投资人持有的 security 列表。investment 对象

investment 对象​

字段类型描述
current_unit_pricenumbersecurity 的当前单价。
current_quantityinteger投资人当前持有的 security 数量。
security_keystring关联 security 的唯一键。
contract_numberstringsecurity 的合同编号。
investment_keystring投资人投资的唯一键。
current_amountnumber投资人持仓的当前金额。