Conversão de Preço (Price Conversion)

O endpoint de Conversão de Preço (Price Conversion) recebe as informações conhecidas de uma negociação de um ativo (como a data e o valor financeiro) e devolve o preço e a quantidade correspondentes nessa data. Após a conversão, a informação retornada pode ser usada para montar a requisição de criação de uma Transação (Transaction).

Isso é útil porque nem sempre a informação disponível sobre uma negociação está no formato exigido pela API. Em fundos e títulos bancários, por exemplo, é comum conhecer apenas o valor aplicado, e não o preço da cota ou do título.

Como converter

A requisição identifica o ativo (security, por id, isin ou cnpj) e a data da negociação (date), além de uma das informações abaixo:

• Valor financeiro (notional): para Fundos e títulos de Renda Fixa Bancária (CDB, LC, LCA, LCI, LIG, entre outros), basta informar o valor total negociado.
• Taxa do título (multiplier ou spread): para títulos de crédito privado (CRI, CRA e Debêntures), informe a taxa da negociação. Use multiplier para títulos que rendem um percentual do indexador (ex.: 110% do CDI → 1.1) e spread para títulos que rendem indexador + taxa (ex.: IPCA + 5% → 0.05).

A requisição também aceita a quantidade negociada (quantity), quando ela é conhecida. Em todos os casos, o objetivo é o mesmo: encontrar o preço e a quantidade a partir de outros dados conhecidos da negociação.

Exemplo

Para converter o valor de R$ 10.000,00 investido em um fundo em preço e quantidade:

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

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

A resposta traz o preço e a quantidade, prontos para uso no endpoint de criação de transações:

//RESPONSE

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

Onde acessar

Para converter os dados de uma negociação em preço e quantidade, consulte o endpoint Price Conversion.