💥Cotação

Esta página contém instruções de como realizar a cotação de valores/moedas através da API da 4P Finance.

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

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

Realiza a conversão de moeda/token.

POST 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*	String	Sua chave API.

Request Body

Name	Type	Description
amount*	String	Valor a ser convertido. Exemplo: 35.99.
convert*	String	Símbolo da moeda/token em que o valor será convertido. Exemplo: USDT.
currency_from_symbol*	String	Símbolo da moeda/token de origem. Exemplo: BRL.

200: OK JSON com dados do valor convertido.

{
    "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"
        }
    }
}