Consulta de Ativo
Este endpoint permite consultar os detalhes de um ativo utilizando sua chave única.
Request
ENDPOINT
/security/security/SECURITY-KEYMÉTODO
GETPath Params
| Campo | Tipo | Descrição | Caracteres |
|---|---|---|---|
SECURITY-KEY | string | Chave única do security (UUID v4). | 36 |
Response
STATUS
200Response Body
{
"tenant_key": "13a6a1d5-7a3c-4627-a0a6-9fd746662ca4",
"security_key": "42bd7161-5ec1-4f64-ac0c-861d93ffb4c2",
"operation_key": "8eb2291e-2dbf-4af1-9d12-f29fac665ed2",
"operation_type": "commercial_paper",
"contract_number": "0000000027",
"issuer_key": "9e08fd62-ce43-4c95-99e0-4386e980d618",
"issuer_name": "Blue Logic",
"issuer_document_number": "97.923.586/0001-06",
"issuer_bank_account": {
"account_type": "checking",
"account_digit": "3",
"account_branch": "0001",
"account_number": "4464541",
"financial_institution_ispb": "32402502",
"financial_institution_code_number": "329"
},
"financial_base_date": "2025-02-18",
"current_unit_price": 1.0,
"latest_accrual_date": "2025-02-18",
"integralized_quantity": 100000,
"issue_quantity": 100000,
"security_status": "active",
"is_defaulted": false,
"financial": {
"financial_base_date": "2025-02-18",
"issue_quantity": 100000,
"unit_price": 1.0,
"issue_amount": 100000.0,
"released_amount": 100000.0,
"cet": 1.0,
"annual_cet": 12.68,
"number_of_installments": 5,
"prefixed_interest_rate": {
"daily_rate": 0.0003271877,
"annual_rate": 0.1268250301,
"monthly_rate": 0.01,
"interest_base": "calendar_days_365"
},
"post_fixed_interest_rate": null,
"financial_index": null,
"fine_delay_rate": {
"daily_rate": 0.00032719,
"annual_rate": 0.12682503,
"monthly_rate": 0.01,
"interest_base": "calendar_days_365"
},
"contract_fine_rate": 0.02,
"fees": [
{
"type": "internal",
"amount": 2.0,
"fee_type": "implementation_fee",
"fee_amount": 2000.0,
"amount_type": "percentage"
},
{
"type": "external",
"amount": 5.0,
"fee_type": "implementation_fee",
"fee_amount": 5000.0,
"amount_type": "percentage"
}
],
"installment_list": [
{
"installment_key": "959a1d8f-9f7f-4b5b-b963-828693caad58",
"installment_status": "opened",
"installment_number": 5,
"workdays": 21,
"calendar_days": 30,
"principal_amortization_unit_price": 0.20395804,
"principal_amortization_amount": 20395.80431829,
"interest_amount": 201.13568171,
"interest_amount_unit_price": 0.00201136,
"post_fixed_interest_amount": 0.0,
"post_fixed_interest_amount_unit_price": 0.0,
"amount": 20596.94,
"due_principal": 20395.80431829,
"due_interest": 0.0,
"due_date": "2025-07-18",
"has_interest": true,
"current_unit_price": 0.20395804,
"latest_accrual_date": "2025-02-18",
"paid_at": null,
"paid_amount": 0.0,
"settlement_process_list": []
},
{
"installment_key": "b1f4fc31-7b73-45b8-bce7-4256394b974e",
"installment_status": "paid",
"installment_number": 1,
"workdays": 18,
"calendar_days": 28,
"principal_amortization_unit_price": 0.19676756,
"principal_amortization_amount": 19676.75638427,
"interest_amount": 920.18361573,
"interest_amount_unit_price": 0.00920184,
"post_fixed_interest_amount": 0.0,
"post_fixed_interest_amount_unit_price": 0.0,
"amount": 20596.94,
"due_principal": 100000.0,
"due_interest": 0.0,
"due_date": "2025-03-18",
"has_interest": true,
"current_unit_price": 0.19676756,
"latest_accrual_date": "2025-02-18",
"paid_at": "2025-02-18T18:39:47.174392",
"paid_amount": 20596.94,
"settlement_process_list": [
{
"settlement_process_key": "a9030b64-5003-4f82-be4f-8296a4e0b140",
"installment_key": "b1f4fc31-7b73-45b8-bce7-4256394b974e",
"due_date": "2025-03-18",
"reference_date": "2025-03-18",
"current_integralized_quantity": 100000,
"principal_amortization_amount": 19676.75638427,
"interest_amount": 920.18361573,
"post_fixed_interest_amount": 0.0,
"fine_amount": 0.0,
"total_amount": 20596.94,
"expected_total_amount": 20596.94,
"paid_amount": 20596.94,
"settlement_process_status": "paid",
"paid_at": "2025-02-18T18:39:47.185004",
"settlement_process_payment_list": [
{
"settlement_process_payment_key": "69615875-ed71-44f2-9a06-20f6ea4276f3",
"investment": {
"investment_key": "4b705afb-18cb-4fe5-922a-5eab71c2b558",
"acquisition_date": "2025-02-18",
"acquisition_unit_price": 1.0,
"acquisition_amount": 100000.0,
"acquisition_quantity": 100000.0,
"investor_key": "a1a75b66-6f7e-4bcc-9ff5-6f8adf7cae09",
"investor_name": "Ultimate Cascade",
"investor_document_number": "31.424.651/0001-32",
"investor_bank_account": {
"account_type": "checking",
"account_digit": "3",
"account_branch": "0001",
"account_number": "33400254",
"financial_institution_ispb": "32402502",
"financial_institution_code_number": "329"
},
"total_sell_amount": 0.0,
"total_yield_amount": 920.18,
"total_amortization_amount": 20596.94,
"current_quantity": 100000,
"investment_transaction_list": [
{
"transaction_type": "integralization",
"transaction_date": "2025-02-18",
"transaction_unit_price": 1.0,
"transaction_amount": 100000.0,
"transaction_quantity": 100000.0,
"amortization_amount": 0.0,
"yield_amount": 0.0,
"old_quantity": 0.0,
"new_quantity": 100000.0,
"investment_transaction_origin": "subscription",
"investment_transaction_origin_key": "8549efc4-76e3-4e62-abd1-71162b383b4e"
},
{
"transaction_type": "maturity",
"transaction_date": "2025-03-18",
"transaction_unit_price": 0.2059694,
"transaction_amount": 20596.94,
"transaction_quantity": 0.0,
"amortization_amount": 20596.94,
"yield_amount": 920.18,
"old_quantity": 100000.0,
"new_quantity": 100000.0,
"investment_transaction_origin": "settlement_process_payment",
"investment_transaction_origin_key": "69615875-ed71-44f2-9a06-20f6ea4276f3"
}
]
},
"investment_quantity": 100000,
"amount": 20596.94,
"paid_at": "2025-02-18T18:39:47.159822",
"settlement_process_payment_status": "paid",
"settlement_process_payment_type": "manual",
"settlement_process_payment_receipt_list": [
{
"settlement_process_payment_receipt_key": "47fa434a-68cc-47d4-af8c-6a84061f38a6",
"settlement_process_payment_receipt_status": "confirmed",
"updated_at": "2025-02-18T18:39:47.153603"
}
]
}
]
}
]
},
{
"installment_key": "dafc9683-a2b3-4bde-bf9a-ff4b2ea2599f",
"installment_status": "opened",
"installment_number": 2,
"workdays": 23,
"calendar_days": 35,
"principal_amortization_unit_price": 0.19671978,
"principal_amortization_amount": 19671.97807672,
"interest_amount": 924.96192328,
"interest_amount_unit_price": 0.00924962,
"post_fixed_interest_amount": 0.0,
"post_fixed_interest_amount_unit_price": 0.0,
"amount": 20596.94,
"due_principal": 80323.24361573,
"due_interest": 0.0,
"due_date": "2025-04-22",
"has_interest": true,
"current_unit_price": 0.19671978,
"latest_accrual_date": "2025-02-18",
"paid_at": null,
"paid_amount": 0.0,
"settlement_process_list": []
},
{
"installment_key": "aab04935-763e-4431-b0e8-d3d341d5c563",
"installment_status": "opened",
"installment_number": 3,
"workdays": 18,
"calendar_days": 27,
"principal_amortization_unit_price": 0.20058857,
"principal_amortization_amount": 20058.85739386,
"interest_amount": 538.08260614,
"interest_amount_unit_price": 0.00538083,
"post_fixed_interest_amount": 0.0,
"post_fixed_interest_amount_unit_price": 0.0,
"amount": 20596.94,
"due_principal": 60651.26553901,
"due_interest": 0.0,
"due_date": "2025-05-19",
"has_interest": true,
"current_unit_price": 0.20058857,
"latest_accrual_date": "2025-02-18",
"paid_at": null,
"paid_amount": 0.0,
"settlement_process_list": []
},
{
"installment_key": "6a76fd8f-631b-4b42-ac2e-daae8f87401d",
"installment_status": "opened",
"installment_number": 4,
"workdays": 22,
"calendar_days": 30,
"principal_amortization_unit_price": 0.20196604,
"principal_amortization_amount": 20196.60382686,
"interest_amount": 400.33617314,
"interest_amount_unit_price": 0.00400336,
"post_fixed_interest_amount": 0.0,
"post_fixed_interest_amount_unit_price": 0.0,
"amount": 20596.94,
"due_principal": 40592.40814515,
"due_interest": 0.0,
"due_date": "2025-06-18",
"has_interest": true,
"current_unit_price": 0.20196604,
"latest_accrual_date": "2025-02-18",
"paid_at": null,
"paid_amount": 0.0,
"settlement_process_list": []
}
]
},
"investment_list": [
{
"investment_key": "4b705afb-18cb-4fe5-922a-5eab71c2b558",
"acquisition_date": "2025-02-18",
"acquisition_unit_price": 1.0,
"acquisition_amount": 100000.0,
"acquisition_quantity": 100000.0,
"investor_key": "a1a75b66-6f7e-4bcc-9ff5-6f8adf7cae09",
"investor_name": "Ultimate Cascade",
"investor_document_number": "31.424.651/0001-32",
"investor_bank_account": {
"account_type": "checking",
"account_digit": "3",
"account_branch": "0001",
"account_number": "33400254",
"financial_institution_ispb": "32402502",
"financial_institution_code_number": "329"
},
"total_sell_amount": 0.0,
"total_yield_amount": 920.18,
"total_amortization_amount": 20596.94,
"current_quantity": 100000,
"investment_transaction_list": [
{
"transaction_type": "integralization",
"transaction_date": "2025-02-18",
"transaction_unit_price": 1.0,
"transaction_amount": 100000.0,
"transaction_quantity": 100000.0,
"amortization_amount": 0.0,
"yield_amount": 0.0,
"old_quantity": 0.0,
"new_quantity": 100000.0,
"investment_transaction_origin": "subscription",
"investment_transaction_origin_key": "8549efc4-76e3-4e62-abd1-71162b383b4e"
},
{
"transaction_type": "maturity",
"transaction_date": "2025-03-18",
"transaction_unit_price": 0.2059694,
"transaction_amount": 20596.94,
"transaction_quantity": 0.0,
"amortization_amount": 20596.94,
"yield_amount": 920.18,
"old_quantity": 100000.0,
"new_quantity": 100000.0,
"investment_transaction_origin": "settlement_process_payment",
"investment_transaction_origin_key": "69615875-ed71-44f2-9a06-20f6ea4276f3"
}
]
}
]
}
Response Body Params
| Campo | Tipo | Descrição |
|---|---|---|
tenant_key | string | Chave única do tenant associado ao security. |
security_key | string | Chave única do security. |
operation_key | string | Chave única da operação associada ao security. |
operation_type | string | Tipo da operação. Valores possíveis: commercial_paper. |
contract_number | string | Número do contrato associado ao security. |
issuer_key | string | Chave única do emissor associado. |
issuer_name | string | Nome do emissor do security. |
issuer_document_number | string | Número do documento do emissor (CPF/CNPJ). |
issuer_bank_account | object | Objeto issuer_bank_account. |
financial_base_date | string | Data base financeira do security. |
current_unit_price | number | Preço unitário atual do security. |
latest_accrual_date | string | Data do último accrual realizado. |
integralized_quantity | integer | Quantidade total de cotas integralizadas. |
issue_quantity | integer | Quantidade total de cotas emitidas na operação. |
security_status | string | Status do security. Valores possíveis: active, inactive. |
is_defaulted | boolean | Indica se o security está inadimplente (true ou false). |
financial | object | Objeto financial. |
investment_list | array | Lista de investimentos. Objeto investment. |
Objeto bank_account
| Campo | Tipo | Descrição |
|---|---|---|
account_number | string | Número da conta bancária do emissor. |
account_digit | string | Dígito verificador da conta bancária do emissor. |
account_branch | string | Agência bancária do emissor. |
financial_institution_ispb | string | ISPB da instituição financeira do emissor. |
financial_institution_code_number | string | Código da instituição financeira do emissor. |
Objeto financial
| Campo | Tipo | Descrição |
|---|---|---|
financial_base_date | string | Data base financeira. |
issue_quantity | integer | Quantidade de cotas emitidas. |
unit_price | number | Preço unitário das cotas. |
issue_amount | number | Valor total da emissão. |
released_amount | number | Valor total liberado. |
cet | number | Custo efetivo total (CET). |
annual_cet | number | Custo efetivo total anualizado. |
number_of_installments | integer | Número total de parcelas. |
prefixed_interest_rate | object | Objeto prefixed_interest_rate. |
post_fixed_interest_rate | object | Objeto post_fixed_interest_rate. |
financial_index | object | Objeto financial_index. |
fine_delay_rate | object | Objeto fine_delay_rate. |
contract_fine_rate | number | Multa contratual. |
fees | array | Lista de taxas. Objeto fees. |
installment_list | array | Lista de parcelas. Objeto installment. |
Objeto investment
| Campo | Tipo | Descrição |
|---|---|---|
investment_key | string | Chave única do investimento. |
acquisition_date | string | Data de aquisição do investimento. |
acquisition_unit_price | number | Preço unitário na aquisição. |
acquisition_amount | number | Valor total da aquisição. |
acquisition_quantity | integer | Quantidade de cotas adquiridas. |
investor_key | string | Chave única do investidor. |
investor_name | string | Nome do investidor. |
investor_document_number | string | Documento do investidor (CPF/CNPJ). |
investor_bank_account | object | Objeto investor_bank_account. |
total_sell_amount | number | Valor total de vendas realizadas. |
total_yield_amount | number | Valor total de rendimentos. |
total_amortization_amount | number | Valor total de amortizações. |
current_quantity | integer | Quantidade atual de cotas. |
investment_transaction_list | array | Lista de transações. Objeto investment_transaction. |
Objeto investment_transaction
| Campo | Tipo | Descrição |
|---|---|---|
transaction_type | string | Tipo da transação (integralization, maturity). |
transaction_date | string | Data da transação. |
transaction_unit_price | number | Preço unitário na transação. |
transaction_amount | number | Valor total da transação. |
transaction_quantity | integer | Quantidade de cotas transacionadas. |
amortization_amount | number | Valor de amortização na transação. |
yield_amount | number | Valor de rendimento na transação. |
old_quantity | integer | Quantidade de cotas antes da transação. |
new_quantity | integer | Quantidade de cotas após a transação. |
investment_transaction_origin | string | Origem da transação (subscription, settlement_process_payment). |
investment_transaction_origin_key | string | Chave da origem da transação. |
Objeto prefixed_interest_rate
| Campo | Tipo | Descrição |
|---|---|---|
daily_rate | number | Taxa de juros diária prefixada. |
annual_rate | number | Taxa de juros anual prefixada. |
monthly_rate | number | Taxa de juros mensal prefixada. |
interest_base | string | Base de cálculo dos juros (calendar_days_365). |
Objeto post_fixed_interest_rate
| Campo | Tipo | Descrição |
|---|---|---|
daily_rate | number | Taxa de juros diária pós-fixada. |
annual_rate | number | Taxa de juros anual pós-fixada. |
monthly_rate | number | Taxa de juros mensal pós-fixada. |
interest_base | string | Base de cálculo dos juros (calendar_days_365). |
Objeto financial_index
| Campo | Tipo | Descrição |
|---|---|---|
index_type | string | Tipo do índice financeiro (CDI, IPCA, etc.). |
index_value | number | Valor do índice financeiro. |
Objeto fine_delay_rate
| Campo | Tipo | Descrição |
|---|---|---|
daily_rate | number | Taxa de juros diária para atraso no pagamento. |
annual_rate | number | Taxa de juros anual para atraso no pagamento. |
monthly_rate | number | Taxa de juros mensal para atraso no pagamento. |
interest_base | string | Base de cálculo dos juros (calendar_days_365). |
Objeto fees
| Campo | Tipo | Descrição |
|---|---|---|
type | string | Tipo da taxa (internal, external). |
amount | number | Percentual ou valor absoluto da taxa. |
fee_type | string | Tipo da taxa (implementation_fee). |
fee_amount | number | Valor monetário da taxa aplicada. |
amount_type | string | Tipo do valor (percentage, absolute). |
Objeto installment
| Campo | Tipo | Descrição |
|---|---|---|
installment_key | string | Chave única da parcela. |
installment_status | string | Status da parcela |
installment_number | integer | Número da parcela na sequência do cronograma. |
workdays | integer | Quantidade de dias úteis até o vencimento. |
calendar_days | integer | Quantidade de dias corridos até o vencimento. |
principal_amortization_unit_price | number | Valor unitário da amortização do principal. |
principal_amortization_amount | number | Valor total da amortização do principal. |
interest_amount | number | Valor total dos juros da parcela. |
interest_amount_unit_price | number | Valor unitário dos juros da parcela. |
post_fixed_interest_amount | number | Valor total dos juros pós-fixados da parcela. |
post_fixed_interest_amount_unit_price | number | Valor unitário dos juros pós-fixados da parcela. |
amount | number | Valor total da parcela. |
due_principal | number | Valor do principal pendente antes da parcela. |
due_interest | number | Valor dos juros pendentes antes da parcela. |
due_date | string | Data de vencimento da parcela. |
has_interest | boolean | Indica se a parcela contém juros (true ou false). |
current_unit_price | number | Preço unitário atualizado da parcela. |
latest_accrual_date | string | Data do último accrual da parcela. |
paid_at | string | Data do pagamento da parcela (se aplicável). |
paid_amount | number | Valor total pago da parcela (se aplicável). |
settlement_process_list | array | Lista de processos de liquidação. Objeto settlement_process |
Objeto settlement_process
| Campo | Tipo | Descrição |
|---|---|---|
settlement_process_key | string | Chave única do processo de liquidação. |
installment_key | string | Chave única da parcela associada à liquidação. |
due_date | string | Data de vencimento da parcela associada. |
reference_date | string | Data de referência da liquidação. |
current_integralized_quantity | integer | Quantidade de cotas integralizadas no momento da liquidação. |
principal_amortization_amount | number | Valor da amortização do principal. |
interest_amount | number | Valor total dos juros pagos na liquidação. |
post_fixed_interest_amount | number | Valor dos juros pós-fixados pagos na liquidação. |
fine_amount | number | Valor da multa aplicada (se houver). |
total_amount | number | Valor total da liquidação. |
expected_total_amount | number | Valor total esperado da liquidação. |
paid_amount | number | Valor total pago na liquidação. |
settlement_process_status | string | Status da liquidação (waiting_payment, paid, canceled). |
paid_at | string | Data do pagamento da liquidação (se aplicável). |
settlement_process_payment_list | array | Lista de pagamentos associados à liquidação. Objeto settlement_process_payment |
Objeto settlement_process_payment
| Campo | Tipo | Descrição |
|---|---|---|
settlement_process_payment_key | string | Chave única do pagamento do processo de liquidação. |
investment | object | Informações do investimento. Objeto investment. |
investment_quantity | integer | Quantidade de cotas do investimento envolvidas no pagamento. |
amount | number | Valor do pagamento realizado. |
paid_at | string | Data e hora do pagamento (formato ISO 8601). |
settlement_process_payment_status | string | Status do pagamento (waiting_payment, paid, canceled). |
settlement_process_payment_type | string | Tipo do pagamento (manual). |
settlement_process_payment_receipt_list | array | Lista de recibos do pagamento. Objeto settlement_process_payment_receipt. |
Objeto settlement_process_payment_receipt
| Campo | Tipo | Descrição |
|---|---|---|
settlement_process_payment_receipt_key | string | Chave única do recibo de pagamento do processo de liquidação. |
settlement_process_payment_receipt_status | string | Status do recibo (waiting_confirmation, confirmed, denied). |
amount | number | Valor do recibo. |
updated_at | string | Data e hora da última atualização do recibo (formato ISO 8601). |
Enumeradores security_status
| Enum | Descrição |
|---|---|
issued | A security foi emitida, mas ainda não está ativa. |
active | A security está ativa e em andamento. |
matured | A security chegou ao vencimento. |
canceled | A security foi cancelada. |
Enumeradores installment_status
| Enum | Descrição |
|---|---|
created | A parcela foi criada, mas ainda não está disponível para pagamento. |
opened | A parcela está aberta. |
waiting_payment | A parcela está aguardando o pagamento pelo investidor. |
paid_partial | A parcela foi parcialmente paga. |
paid | A parcela foi totalmente paga. |
paid_early | A parcela foi paga antecipadamente. |
overdue | A parcela venceu e não foi paga. |
paid_partial_overdue | A parcela foi parcialmente paga após o vencimento. |
paid_overdue | A parcela foi paga após o vencimento. |
canceled | A parcela foi cancelada e não precisa ser paga. |
unmonitored | A parcela não é monitorada para pagamentos. |