跳到主要内容

获取投资者已结算持仓信息

Request​

ENDPOINT
/quota_distributor/investor/INVESTOR_KEY/investor_position_closings
MÉTODO
GET

Query Params​

参数描述
closing_date特定结算日期
from_date区间起始日期
to_date区间结束日期
注意

使用该资源有两种方式：

  • 查询特定日期，将 closing_date 字段作为 query param 发送。
  • 查询某个区间，将 from_date 和 to_date 字段作为 query param 发送。

如果同时发送三个参数，将返回错误代码 [QDI000080]

Responses​

STATUS
200
响应示例
{
    "data": [
        {
        "accounting_date":"2024-03-06",
        "total_value":1100.0,
        "number_of_quotas":11.0,
        "ir_value":0.0,
        "iof_value":0.0,
        "yield_value":0.0,
        "yield_net_value":0.0,
        "issuance_serie": {
            "name": "1",
            "cetip_code": "0000000SN1",
            "start_date": "YYYY-MM-DD",
            "maturity_date": "YYYY-MM-DD",
            "original_quota_value": 0.00000000000000,
            "remuneration_type": "yield_curve",
            "interest_rate_type": "post_fixed",
            "pre_fixed": {
                "calendar_base": "workdays / calendar_360 / calendar_365",
                "monthly_rate": 0.00000000000000
            },
            "post_fixed": {
                "calendar_base": "workdays / calendar_360 / calendar_365",
                "indexer": "di / ipca",
                "rate": 1,
                "lag": {"reference": "daily / monthly", "amount": 1},
            },
            "investment_category": "fidc / multi_market",
            "condominum_type": "open_ended / close_ended",
            "tax_classification": "short_term / long_term",
            "investment_restriction_type": "just_professional",
            "issuance_serie_key": "UUID",
            "minimum_share_capital": 0.0,
            "accounting_date": "YYYY-MM-DD",
            "sub_class": {
                "name": "COTA SÊNIOR",
                "sub_class_key": "UUID",
                "subordination_level": 1,
                "fund_class": {
                    "name": "SAMPLE FUND CLASS NAME",
                    "fund_class_key": "UUID",
                    "document_number": "00.000.000/0000-00"
                }
            }
        }
      }
    ],
    "limit": 50,
    "page": 0,
    "is_last_page": true
}

响应字段​

字段类型描述
dataarrayInvestor Position Closing 对象列表
limitint每页返回的对象数量限制
pageint当前返回的页码
is_last_pageboolean表示当前页是否为最后一页

Investor Position Closing​

字段类型描述
accounting_datestring结算参考日期
total_valuefloat投资者已结算持仓总资产净值
number_of_quotasfloat投资者已结算持仓的份额数量
ir_valuefloat投资者已结算持仓的所得税金额
iof_valuefloat投资者已结算持仓的金融操作税金额
yield_valuefloat投资者已结算持仓的收益金额
yield_net_valuefloat投资者已结算持仓的净收益金额
issuance_serieJSONIssuance Serie 对象

Issuance Serie​

字段类型描述字符数
namestring发行系列名称最多 255
issuance_serie_keystring发行系列唯一标识键36
cetip_codestring发行系列在 CETIP 中的资产代码10
start_datestring发行系列起始日期10
maturity_datestring发行系列到期日期10
original_quota_valuefloat原始份额价值-
remuneration_typestring收益曲线 / 残差最多 50
investment_categorystringFIDC / 多市场最多 50
condominum_typestring开放式 / 封闭式最多 50
tax_classificationstring短期 / 长期最多 50
investment_restriction_typestring无限制 / 合格投资者 / 专业投资者最多 50
minimum_share_capitalfloat最低申购金额-
accounting_datestring发行系列会计日期10
sub_classJSONSub Class 对象-

Sub Class​

字段类型描述字符数
namestring子类名称最多 255
sub_class_keystring子类唯一标识键36
subordination_levelint子类从属层级-
fund_classJSONFund Class 对象-

Fund Class​

字段类型描述字符数
namestring基金类别名称最多 255
fund_class_keystring基金类别唯一标识键36
document_numberstring基金类别 CNPJ-