💥Conversão de moedas/tokens

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

Para realizar transações em sua aplicação, é necessário realizar a conversão do valor a ser cobrado em BRL / REAL para a moeda/token escolhido pelo usuário. Essa conversão visa obter a cotação da moeda/token escolhida e retornar o valor total convertido, para só após a conversão, iniciar a criação da transação.

Utilizando o endpoint /transaction/price_conversion você conseguirá obter a conversão do valor solicitado em BRL/REAL para o valor atualizado na moeda/token escolhido pelo usuário.

Requisição

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
id*	String	ID da moeda que será convertida. Atualmente é somente permitido o valor 2783, que corresponde a moeda BRL/REAL.
amount*	String	Valor a ser convertido. Exemplo: 35.99.
convert*	String	Símbolo da moeda/token em que o valor será convertido. Exemplo: MATIC.
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": "35.99",
            "last_updated": "2023-02-16T20:49:27.000Z",
            "quote": {
                "MATIC": {
                    "price": 4.8426885869931064,
                    "last_updated": "2023-02-16T20:49:00.000Z"
                }
            },
            "origin": "api"
        }
    }
}