Consulta de Aplicações Financeiras por Classe de Fundo
Retorna, paginadas, as aplicações financeiras que a sua classe de fundo fez em cotas de outros fundos.
Disponível em
| Perfil | Host | Permissão exigida |
|---|---|---|
| Gestora | manager-api | Leitura |
| Consultoria | consultant-api | Ler Aplicações, Resgates e Séries |
URL base de cada host: Ambientes (Hosts).
Request
ENDPOINT
/trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_applicationsMÉTODO
GETQuery Params
| Parâmetro | Tipo | Descrição |
|---|---|---|
page | int | Número da página, a partir de 0. Padrão: 0. |
limit | int | Registros por página. Padrão: 10. Máximo: 50. |
quotation_date | data | Data de cotização exata (YYYY-MM-DD). |
quotation_date_from | data | Data de cotização inicial (YYYY-MM-DD). |
quotation_date_to | data | Data de cotização final (YYYY-MM-DD). Não pode ser anterior a quotation_date_from. |
financial_application_status | lista | Status a incluir, separados por vírgula (ex.: pending_manager_approval,pending_payment). |
not_financial_application_status | lista | Status a excluir, separados por vírgula. |
document_number | string | CNPJ da classe do fundo investido, com pontuação. Correspondência exata. |
internal_codes | lista | Códigos internos das séries investidas, separados por vírgula. |
asset_type | string | Tipo do ativo (ex.: fidc_fund_quota, multi_market_fund_quota). |
sub_class_name | lista | Nomes de subclasse da série investida, separados por vírgula (sem diferenciar acento e maiúscula). |
search | string | Busca parcial no nome curto do fundo investido, no nome da série, no código interno ou no CNPJ. |
Os status possíveis estão em Criar Aplicação Financeira.
Response
STATUS
200Caso 01: Retorno com uma aplicação
{
"data": [
{
"amount": 0.00,
"financial_application_key": "UUID",
"asset_key": "UUID",
"quotation_date": "YYYY-MM-DD",
"status": "confirmed",
"issuance_serie": {
"issuance_serie_key": "UUID",
"name": "Invested Issuance Serie Name",
"subclass_name": "Invested Sub Class Name",
"serie": 1,
"quota_calculation_method": "quota_value",
"internal_code": "Internal Code",
"fund_class_name": "Invested Fund Class Name",
"fund_class_short_name": "Invested Fund Class short name",
"fund_class_document_number": "00.000.000/0000-00",
"minimum_share_capital": 0.0,
"investment_category": "multi_market",
"payment_type": "transfer",
"account_data": {
"account_digit": "0",
"account_branch": "0001",
"account_number": "12345",
"financial_institution_code": "329",
"financial_institution_ispb": "00000000"
},
"last_updated_date": "YYYY-MM-DD",
"administrator": {
"administrator_key": "UUID",
"name": "Administrator Name",
"document_number": "00.000.000/0000-00"
},
"operation_periods": {
"redemption_request": {
"payment": {
"days": 1,
"type": "until",
"calendar_base": "calendar_365"
},
"quotation": {
"days": 1,
"type": "fixed",
"calendar_base": "calendar_365"
}
},
"amortization_request": {
"payment": {
"days": 0,
"type": "fixed",
"calendar_base": "workdays"
},
"quotation": {
"days": 0,
"type": "fixed",
"calendar_base": "workdays"
}
},
"financial_application": {
"payment": {
"days": 0,
"type": "fixed",
"calendar_base": "workdays"
},
"quotation": {
"days": 0,
"type": "fixed",
"calendar_base": "workdays"
}
}
},
"isin_code": "BR000000000"
},
"fund_class": {
"fund_class_key": "UUID",
"name": "Fund Class Name",
"short_name": "Fund Class Short Name",
"document_number": "00.000.000/0000-00",
"accounting_date": "YYYY-MM-DD",
"distributor": {
"name": "Distributor Name",
"distributor_key": "UUID",
"document_number": "00.000.000/0000-00"
},
"manager": {
"manager_key": "UUID",
"manager_name": "Manager Name",
"document_number": "00.000.000/0000-00"
}
}
}
],
"limit": 10,
"page": 0,
"is_last_page": true
}
Page
| Campo | Tipo | Descrição |
|---|---|---|
data | array | Lista de objetos de Financial Application |
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 |
Financial Application
| Campo | Tipo | Descrição |
|---|---|---|
| amount | float | Valor aplicado |
| financial_application_key | string | Chave única da aplicação financeira |
| asset_key | string | Chave do ativo relacionado |
| quotation_date | string | Data de cotização (YYYY-MM-DD) |
| payment_date | string | Data de pagamento (YYYY-MM-DD) |
| payment_method | string | wire_transfer ou pix |
| payment_type | string | transfer ou automatic_debit |
| status | string | Status da aplicação |
| external_financial_application_key | string | Identificador externo da aplicação financeira |
| iof_amount | float | IOF da aplicação; presente quando calculado |
| number_of_quotas | float | Quantidade de cotas; presente após a cotização |
| issuance_serie | JSON | Objeto de Issuance Serie |
| fund_class | JSON | Objeto de Fund Class |
Issuance Serie
| Campo | Tipo | Descrição |
|---|---|---|
| issuance_serie_key | string | Chave única da série de emissão |
| name | string | Nome da série de emissão |
| subclass_name | string | Nome da subclasse (ex: SUBORDINADA) |
| serie | int | Número da série |
| quota_calculation_method | string | Método de cálculo da cota (ex: quota_value) |
| internal_code | string | Código interno da série |
| fund_class_name | string | Nome da classe do fundo associado à série |
| fund_class_short_name | string | Nome curto da classe do fundo |
| fund_class_document_number | string | CNPJ da classe do fundo |
| minimum_share_capital | float | Valor mínimo para aplicação |
| investment_category | string | Categoria do investimento (ex: multi_market) |
| payment_type | string | Tipo de pagamento (ex: transfer) |
| account_data | JSON | Objeto de Account Data |
| last_updated_date | string | Última data de atualização (YYYY-MM-DD) |
| administrator | JSON | Objeto de Administrator |
| operation_periods | JSON | Objeto de Operation Periods |
| isin_code | string | Código ISIN da série |
Administrator
| Campo | Tipo | Descrição |
|---|---|---|
| administrator_key | string | Chave única do administrador |
| name | string | Nome do administrador |
| document_number | string | CNPJ do administrador |
Operation Periods
| Campo | Tipo | Descrição |
|---|---|---|
| redemption_request | JSON | Objeto de períodos de Cotização e Pagamento para resgates |
| amortization_request | JSON | Objeto de períodos de Cotização e Pagamento amortizações |
| financial_application | JSON | Objeto de períodos de Cotização e Pagamento aplicações |
Quotation and Payment
| Campo | Tipo | Descrição |
|---|---|---|
| days | int | Quantidade de dias |
| type | string | Tipo de contagem (ex: fixed, until) |
| calendar_base | string | Base de calendário (ex: workdays, calendar_365) |
Account Data
| Campo | Tipo | Descrição |
|---|---|---|
| account_digit | string | Dígito da conta bancária |
| account_branch | string | Número da agência bancária |
| account_number | string | Número da conta bancária |
| financial_institution_code | string | Código da instituição financeira |
| financial_institution_ispb | string | ISPB da instituição financeira (Sistema de Pagamentos Brasileiro) |
Fund Class
| Campo | Tipo | Descrição |
|---|---|---|
| fund_class_key | string | Chave única da classe de fundo |
| name | string | Nome completo da classe de fundo |
| short_name | string | Nome curto da classe de fundo |
| document_number | string | CNPJ da classe de fundo |
| accounting_date | string | Data contábil mais recente |
| distributor | JSON | Objeto de Distributor |
| manager | JSON | Objeto de Manager |
Distributor
| Campo | Tipo | Descrição |
|---|---|---|
| name | string | Nome do distribuidor |
| distributor_key | string | Chave única do distribuidor |
| document_number | string | CNPJ do distribuidor |
Manager
| Campo | Tipo | Descrição |
|---|---|---|
| manager_key | string | Chave única do gestor |
| manager_name | string | Nome do gestor da classe de fundo |
| document_number | string | CNPJ do gestor |
Erros
| Status | Código | Quando acontece |
|---|---|---|
| 400 | TFQ000218 | quotation_date_from posterior a quotation_date_to. |
| 403 | TFQ000054 | A classe de fundo não pertence à sua gestora. |
| 404 | TFQ000005 | Classe de fundo não encontrada. |
Erros de autenticação, permissão e host: veja Erros da API.