> For the complete documentation index, see [llms.txt](https://developer.bemfacil.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.bemfacil.com.br/servicos/cotacao-bemfacil-r/realizar-cotacao.md).

# Realizar Cotação

O método `getCotacoes` permite que você acesse cotações financeiras atualizadas de diversos ativos importantes. Ele fornece informações essenciais sobre os seguintes ativos:

1. **IBOV**: O índice Ibovespa, que é o principal indicador do desempenho das ações negociadas na Bolsa de Valores brasileira.
2. **EUSCOM**: O Dólar Comercial, que representa a taxa de câmbio utilizada em transações comerciais no mercado brasileiro.
3. **EUSTUR**: O Dólar Turismo, que indica a taxa de câmbio usada para operações de câmbio voltadas para turistas.
4. **BTCUSDTBIN**: O Bitcoin no par USDT (Tether) na Exchange Binance, que mostra o valor do Bitcoin em relação ao Tether, uma criptomoeda estável.

<mark style="color:green;">`POST`</mark> [<mark style="color:green;">`https://cotacoes-stage.bemfacil.com.br/getCotacoes`</mark>](https://cotacoes-stage.bemfacil.com.br/getCotacoes)

### Headers

| Name          | Type         | Description                              |
| ------------- | ------------ | ---------------------------------------- |
| Authorization | Bearer Token | Token de autorização para utilizar a API |

### Request Body

{% hint style="info" %}
Este endpoint não tem um request body
{% endhint %}

### Response Body

| Name     | Field Name | Type    | Description                                                                                                                                                                                                                                                  |
| -------- | ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Cotacoes |            | List    | Lista de Cotações                                                                                                                                                                                                                                            |
|          | Abe        | Integer | Valor de abertura no dia                                                                                                                                                                                                                                     |
|          | Cod        | String  | <p>Código do ativo (</p><p><strong>IBOV</strong>: Índice Ibovespa</p><p><strong>EUSCOM</strong>: Dólar Comercial Mercado</p><p><strong>EUSTUR</strong>: Dólar Turismo</p><p><strong>BTCUSDTBIN</strong>: Bitcoin par no USDT \[Exchange Binance]</p><p>)</p> |
|          | Data       | String  | Data de referência da cotação                                                                                                                                                                                                                                |
|          | Fec        | Integer | Valor de fechamento do mercado anterior                                                                                                                                                                                                                      |
|          | Hor        | String  | Horário da cotação do campo (Ult), formato: HH:mm                                                                                                                                                                                                            |
|          | Max        | Integer | Valor máximo no dia                                                                                                                                                                                                                                          |
|          | Min        | Integer | Valor minimo no dia                                                                                                                                                                                                                                          |
|          | Ocp        | Integer | Valor da compra                                                                                                                                                                                                                                              |
|          | Ovd        | Integer | Valor da venda                                                                                                                                                                                                                                               |
|          | URLGrafico | String  | Link do gráfico diário                                                                                                                                                                                                                                       |
|          | Ult        | Integer | Valor do último negócio realizado                                                                                                                                                                                                                            |
|          | Var        | Float   | Variação percentual no momento  da consulta                                                                                                                                                                                                                  |

### Exemplos

{% tabs %}
{% tab title="JavaScript" %}

```javascript
const myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer *******");

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  redirect: "follow"
};

fetch("https://cotacoes.bemfacil.com.br/getCotacoes", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));
```

{% endtab %}

{% tab title="Python" %}

```python
import requests

url = "https://cotacoes.bemfacil.com.br/getCotacoes"

payload = {}
headers = {
  'Authorization': 'Bearer *******'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

```

{% endtab %}

{% tab title="Ruby" %}

```ruby
require "uri"
require "net/http"

url = URI("https://cotacoes.bemfacil.com.br/getCotacoes")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer **********"

response = https.request(request)
puts response.read_body

```

{% endtab %}
{% endtabs %}