> For the complete documentation index, see [llms.txt](https://docs.4p.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.4p.finance/cotacao.md).

# Cotação

Caso deseje realizar a cotação do valor em BRL (Real) para a moeda ou token de destino, você pode utilizar o endpoint de cotação antes de criar a transação.

Essa conversão tem como objetivo:

* Obter a taxa de conversão atual da moeda/token selecionado;
* Retornar o valor final já convertido para criptomoeda;

Utilizando o endpoint `/transaction/price_conversion` você conseguirá obter a cotação do valor solicitado em BRL/REAL para o valor atualizado na criptomoeda escolhida.

### Exemplo de payload

```json
{
  "amount": "50.10",
  "currency_from_symbol": "BRL",
  "convert": "USDT"  
}
```

## Realiza a conversão de moeda/token.

<mark style="color:green;">`POST`</mark> `https://api.4p.finance/v1/transaction/price_conversion`

Retorna JSON com o valor total solicitado convertido na moeda/token escolhido.

#### Headers

| Name                                        | Type   | Description    |
| ------------------------------------------- | ------ | -------------- |
| x-api-key<mark style="color:red;">\*</mark> | String | Sua chave API. |

#### Request Body

| Name                                                     | Type   | Description                                                           |
| -------------------------------------------------------- | ------ | --------------------------------------------------------------------- |
| amount<mark style="color:red;">\*</mark>                 | String | Valor a ser convertido. Exemplo: 35.99.                               |
| convert<mark style="color:red;">\*</mark>                | String | Símbolo da moeda/token em que o valor será convertido. Exemplo: USDT. |
| currency\_from\_symbol<mark style="color:red;">\*</mark> | String | Símbolo da moeda/token de origem. Exemplo: BRL.                       |

{% tabs %}
{% tab title="200: OK JSON com dados do valor convertido." %}

```javascript
{
    "http_code": 200,
    "success": true,
    "info": {
        "result": "price_conversion_success",
        "message": "Price conversion successfully.",
        "data": {
            "id": 2783,
            "symbol": "BRL",
            "name": "Brazilian Real",
            "amount": "250.00",
            "last_updated": "2023-02-16T20:49:27.000Z",
            "quote": {
                "BTC": {
                    "price": 47.33,
                    "last_updated": "2026-01-01T20:49:00.000Z"
                }
            },
            "origin": "api",
            "dbprice": "bce"
        }
    }
}
```

{% endtab %}
{% endtabs %}