Skip to main content

Recuperando Informações da Posição do Investidor


Request

ENDPOINT
/quota_distributor/investor/INVESTOR_KEY/investor_positions
METHOD
GET

Responses

STATUS
200
Caso 01: Investidor com Posição em somente uma série de COTA ÚNICA
{
"data": [
{
"investor": {
"distributor": {
"distributor_key": "UUID",
"document_number": "00.000.000/0000-00",
"name": "SAMPLE DISTRIBUTOR NAME",
"account_data": {
"owner": {
"name": "SAMPLE DISTRIBUTOR NAME",
"document_number": "00.000.000/0000-00"
},
"account_digit": "0",
"account_branch": "0000",
"account_number": "00000",
"financial_institution_code": "000",
"financial_institution_ispb": "00000000"
}
},
"investor_key": "UUID",
"document_number": "00.000.000/0000-00",
"name": "SAMPLE INVESTOR NAME",
"person_type": "natural_person / legal_person / fund_class",
"account_data": {
"account_digit": "0",
"account_branch": "0000",
"account_number": "00000",
"financial_institution_code": "000",
"financial_institution_ispb": "00000000"
},
"investor_sub_type": "person / financial_institution"
},
"total_net_worth": 0.00,
"total_number_of_quotas": 0.00000000000000,
"issuance_serie": {
"name": "1",
"cetip_code": "0000000UN1",
"start_date": "YYYY-MM-DD",
"maturity_date": "YYYY-MM-DD",
"original_quota_value": 0.00000000000000,
"remuneration_type": "residual",
"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 ÚNICA",
"sub_class_key": "UUID",
"subordination_level": 0,
"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
}
Caso 02: Investidor com Posição em somente uma série de COTA SÊNIOR
{
"data": [
{
"investor": {
"distributor": {
"distributor_key": "UUID",
"document_number": "00.000.000/0000-00",
"name": "SAMPLE DISTRIBUTOR NAME",
"account_data": {
"owner": {
"name": "SAMPLE DISTRIBUTOR NAME",
"document_number": "00.000.000/0000-00"
},
"account_digit": "0",
"account_branch": "0000",
"account_number": "00000",
"financial_institution_code": "000",
"financial_institution_ispb": "00000000"
}
},
"investor_key": "UUID",
"document_number": "00.000.000/0000-00",
"name": "SAMPLE INVESTOR NAME",
"person_type": "natural_person / legal_person / fund_class",
"account_data": {
"account_digit": "0",
"account_branch": "0000",
"account_number": "00000",
"financial_institution_code": "000",
"financial_institution_ispb": "00000000"
},
"investor_sub_type": "person / financial_institution"
},
"total_net_worth": 0.00,
"total_number_of_quotas": 0.00000000000000,
"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
}
Caso 03: Investidor com Posição em duas uma séries, uma COTA SÊNIOR e uma COTA SUBORDINADA
{
"data":[
{
"investor":{
"distributor":{
"distributor_key":"UUID",
"document_number":"00.000.000/0000-00",
"name":"SAMPLE DISTRIBUTOR NAME",
"account_data":{
"owner":{
"name":"SAMPLE DISTRIBUTOR NAME",
"document_number":"00.000.000/0000-00"
},
"account_digit":"0",
"account_branch":"0000",
"account_number":"00000",
"financial_institution_code":"000",
"financial_institution_ispb":"00000000"
}
},
"investor_key":"UUID",
"document_number":"00.000.000/0000-00",
"name":"SAMPLE INVESTOR NAME",
"person_type":"natural_person / legal_person / fund_class",
"account_data":{
"account_digit":"0",
"account_branch":"0000",
"account_number":"00000",
"financial_institution_code":"000",
"financial_institution_ispb":"00000000"
},
"investor_sub_type":"person / financial_institution"
},
"total_net_worth":0.00,
"total_number_of_quotas":0.00000000000000,
"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"
}
}
}
},
{
"investor":{
"distributor":{
"distributor_key":"UUID",
"document_number":"00.000.000/0000-00",
"name":"SAMPLE DISTRIBUTOR NAME",
"account_data":{
"owner":{
"name":"SAMPLE DISTRIBUTOR NAME",
"document_number":"00.000.000/0000-00"
},
"account_digit":"0",
"account_branch":"0000",
"account_number":"00000",
"financial_institution_code":"000",
"financial_institution_ispb":"00000000"
}
},
"investor_key":"UUID",
"document_number":"00.000.000/0000-00",
"name":"SAMPLE INVESTOR NAME",
"person_type":"natural_person / legal_person / fund_class",
"account_data":{
"account_digit":"0",
"account_branch":"0000",
"account_number":"00000",
"financial_institution_code":"000",
"financial_institution_ispb":"00000000"
},
"investor_sub_type":"person / financial_institution"
},
"total_net_worth":0.00,
"total_number_of_quotas":0.00000000000000,
"issuance_serie":{
"name":"1",
"cetip_code":"0000000JR1",
"start_date":"YYYY-MM-DD",
"maturity_date":"YYYY-MM-DD",
"original_quota_value":0.00000000000000,
"remuneration_type":"residual",
"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 SUBORDINADA",
"sub_class_key":"UUID",
"subordination_level":0,
"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

CampoTipoDescrição
dataarrayLista de objetos de Investor Position
limitintLimite de objetos recuperados por página
pageintNúmero da página recuperada
is_last_pagebooleanInformação que indica se a página recuperada é a última

Investor Position

CampoTipoDescrição
investorJSONObjeto de Investor
total_net_worthfloatPatrimônio Líquido da posição do investidor
total_number_of_quotasfloatNúmero de cotas da posição do investidor
issuance_serieJSONObjeto de Issuance Serie

Investor

CampoTipoDescriçãoCaracteres
namestringNome do investidoraté 255
investor_keystringChave única de identificação do investidor36
document_numberstringCPF/CNPJ do investidor14 ou 18
person_typestringPessoa Física / Pessoa Jurídica / Classe de Fundoaté 50
investor_sub_typestringDefault / Instituição Financeiraaté 50
distributorJSONObjeto de Distributor-
account_dataJSONObjeto de Account Data-

Distributor

CampoTipoDescriçãoCaracteres
namestringNome do distribuidoraté 255
distributor_keystringChave única de identificação do distribuidor-
document_numberstringCPF/CNPJ do distribuidor14 ou 18
account_dataJSONObjeto de Account Data-

Account Data

CampoTipoDescrição
account_digitstringDígito da conta bancária
account_branchstringN° da agência da conta bancária
account_numberstringN° da conta bancária
financial_institution_codestringCódigo da instituição financeira
financial_institution_ispbstringIdentificador no Sistema de Pagamento Brasileiro da instituição financeira

Issuance Serie

CampoTipoDescriçãoCaracteres
namestringNome da série de emissãoaté 255
issuance_serie_keystringChave única de identificação da série de emissão36
cetip_codestringCódigo da série de emissão como ativo na CETIP10
start_datestringData de início da série de emissão10
maturity_datestringData de vencimento da série de emissão10
original_quota_valuefloatValor de cota original-
remuneration_typestringCurva de rendimento / Residualaté 50
investment_categorystringFIDC / Multimercadoaté 50
condominum_typestringAberto / Fechadoaté 50
tax_classificationstringCurto prazo / Longo prazoaté 50
investment_restriction_typestringSem restrição / Qualificado / Profissionalaté 50
minimum_share_capitalfloatValor mínimo para aplicação-
accounting_datestringData contábil da série de emissão10
sub_classJSONObjeto de Sub Class-

Sub Class

CampoTipoDescriçãoCaracteres
namestringNome da sub classeaté 255
sub_class_keystringChave única de identificação da sub classe36
subordination_levelintNível de subordinação da sub classe-
fund_classJSONObjeto de Fund Class-

Fund Class

CampoTipoDescriçãoCaracteres
namestringNome da classe de fundoaté 255
fund_class_keystringChave única de identificação da classe de fundo36
document_numberstringCNPJ da classe de fundo-