Recuperando Informações da Posição Fechada do Investidor
Request
ENDPOINT
/quota_distributor/investor/INVESTOR_KEY/investor_position_closingsMÉTODO
GETQuery Params
Parâmetro | Descrição |
---|---|
closing_date | Data de fechamento específica |
from_date | Data de início do período |
to_date | Data de fim do período |
Atenção
Existem duas formas de consumir o recurso:
- Consumindo uma data em específico, enviando como query param o campo closing_date.
- Consumindo um período, enviando como query param os campos from_date e to_date
Caso seja enviado os três parâmetros, será retornado um erro com o código [QDI000080]
Responses
STATUS
200Exemplo de resposta
{
"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
}
Response Fields
Campo | Tipo | Descrição |
---|---|---|
data | array | Lista de objetos de Investor Position Closing |
limit | int | Limite de objetos recuperados por página |
page | int | Número da página recuperada |
is_last_page | boolean | Informação que indica se a página recuperada é a última |
Investor Position Closing
Campo | Tipo | Descrição |
---|---|---|
accounting_date | string | Data de referência do fechamento |
total_value | float | Patrimônio total da posição fechada do investidor |
number_of_quotas | float | Número de cotas da posição fechada do investidor |
ir_value | float | IR da posição fechada do investidor |
iof_value | float | IOF da posição fechada do investidor |
yield_value | float | Rendimento da posição fechada do investidor |
yield_net_value | float | Rendimento líquido da posição fechada do investidor |
issuance_serie | JSON | Objeto de Issuance Serie |
Issuance Serie
Campo | Tipo | Descrição | Caracteres |
---|---|---|---|
name | string | Nome da série de emissão | até 255 |
issuance_serie_key | string | Chave única de identificação da série de emissão | 36 |
cetip_code | string | Código da série de emissão como ativo na CETIP | 10 |
start_date | string | Data de início da série de emissão | 10 |
maturity_date | string | Data de vencimento da série de emissão | 10 |
original_quota_value | float | Valor de cota original | - |
remuneration_type | string | Curva de rendimento / Residual | até 50 |
investment_category | string | FIDC / Multimercado | até 50 |
condominum_type | string | Aberto / Fechado | até 50 |
tax_classification | string | Curto prazo / Longo prazo | até 50 |
investment_restriction_type | string | Sem restrição / Qualificado / Profissional | até 50 |
minimum_share_capital | float | Valor mínimo para aplicação | - |
accounting_date | string | Data contábil da série de emissão | 10 |
sub_class | JSON | Objeto de Sub Class | - |
Sub Class
Campo | Tipo | Descrição | Caracteres |
---|---|---|---|
name | string | Nome da sub classe | até 255 |
sub_class_key | string | Chave única de identificação da sub classe | 36 |
subordination_level | int | Nível de subordinação da sub classe | - |
fund_class | JSON | Objeto de Fund Class | - |
Fund Class
Campo | Tipo | Descrição | Caracteres |
---|---|---|---|
name | string | Nome da classe de fundo | até 255 |
fund_class_key | string | Chave única de identificação da classe de fundo | 36 |
document_number | string | CNPJ da classe de fundo | - |