Conversão de preço

O novo endpoint Price Conversion converte as informações que você conhece de uma negociação, como o valor aplicado, no preço (price) e na quantidade (quantity) necessários para criar uma transação.

Isso é especialmente útil para títulos bancários (CDB, LC, LCI, LCA, LF), cujas transações passaram a exigir price e quantity, e não apenas quantity.

A requisição identifica o ativo (security, por id, isin ou cnpj) e a data da negociação (date), além do valor financeiro (notional) ou, para CRI, CRA e debêntures, da taxa da negociação (multiplier ou spread). São aceitos títulos bancários (CDB, LC, LCI, LCA, LF), todos os tipos de cotas de fundos e títulos de crédito privado (CRI, CRA e debêntures).

Por exemplo, para converter R$ 10.000,00 aplicados em um fundo:

// REQUEST
// POST https://core.gorila.com.br/securities/price-conversions

{
  "security": {
    "cnpj": "26673556000132"
  },
  "date": "2023-06-23",
  "notional": 10000
}

// RESPONSE

{
  "security": {
    "id": 2363053,
    "cnpj": "26673556000132",
    "name": "ALASKA INSTITUCIONAL FIA",
    "type": "FUNDQUOTE",
    "assetClass": "STOCKS"
  },
  "date": "2023-06-23",
  "price": 3.2519722,
  "quantity": 3075.0570377
}

O price e a quantity retornados estão prontos para uso no endpoint Create Transaction.

Saiba mais em Conversão de Preço.