RatesQuickex Exchange Rates: Retrieval and Calculation

Equipe Quickex

17 de novembro de 2025

~1 min de leitura

A seção Rates fornece métodos para obter as taxas de câmbio atuais na plataforma Quickex.
Uma taxa é entendida como a relação entre uma moeda e outra dentro de um determinado par de negociação
(por exemplo, BTC → USDT).

Esses dados permitem criar calculadoras de troca, exibir cotações atualizadas para o usuário
e determinar quanto da moeda de destino você receberá ao realizar uma troca.
Nesta seção, há um método disponível para obter uma taxa específica em formato JSON.

GET

public/one

Endpoint URL

https://quickex.io/api/v1/rates/public/one

Documentation

Retorna a taxa de câmbio pública atual para o par de negociação especificado.
Este método é usado para calcular uma direção de troca específica, levando em conta o valor inserido, o modo da taxa e os parâmetros adicionais.

URL

https://quickex.io/api/v1/rates/public/one

Parâmetros da Query

Parâmetro	Tipo	Obrigatório	Descrição
`exchangeType`	string	sim	Tipo de troca (por exemplo, `crypto`).
`instrumentFromCurrencyTitle`	string	sim	Moeda de origem (por exemplo, `BTC`).
`instrumentFromNetworkTitle`	string	sim	Rede da moeda de origem (por exemplo, `BTC` ou `ERC20`).
`instrumentToCurrencyTitle`	string	sim	Moeda de destino (por exemplo, `USDT`).
`instrumentToNetworkTitle`	string	sim	Rede da moeda de destino (por exemplo, `TRC20`).
`claimedDepositAmount`	string	não	Valor do depósito para o cálculo da taxa.
`rateMode`	string	não	Modo da taxa: `FLOATING` (flutuante) ou `FIXED` (fixa).
`claimedDepositAmountCurrency`	string	sim	Moeda na qual o valor do depósito é especificado (por exemplo, `USDT`).
`markup`	string	não	Markup aplicado à taxa (por exemplo, `1.00`).
`referrerId`	string	não	Identificador do parceiro/referência (por exemplo, `aff_some-affiliate-id`).

Exemplo de solicitação (cURL)

curl -X GET \
  'https://quickex.io/api/v1/rates/public/one?exchangeType=crypto&instrumentFromCurrencyTitle=BTC&instrumentFromNetworkTitle=BTC&instrumentToCurrencyTitle=USDT&instrumentToNetworkTitle=TRC20&claimedDepositAmount=1.00&rateMode=FLOATING&claimedDepositAmountCurrency=USDT&markup=1.00&referrerId=aff_some-affiliate-id' \
  -H 'Accept: application/json'

Exemplo de resposta (422 — erro)

{
  "status": "ERR_CLAIMED_DEPOSIT_AMOUNT_TOO_SMALL",
  "message": "Claimed Deposit Amount Too Small Error",
  "data": {
    "localizedMessage": "O valor informado é 1. O valor mínimo processável é 108.51",
    "details": {
      "field": "claimedDepositAmount",
      "value": "1",
      "expected": "108.51",
      "expectedGeneral": "108.51"
    }
  }
}

Exemplo de resposta (200 — sucesso)

{
  "depositRules": {
    "minAmount": "1000.1",
    "maxAmount": "1000.1"
  },
  "withdrawalRules": {
    "minAmount": "1000.1",
    "maxAmount": "1000.1",
    "withdrawalFeeRules": {
      "minAmount": "1000.1",
      "maxAmount": "1000.1"
    }
  },
  "minConfirmationsToWithdraw": 0,
  "minConfirmationsToTrade": 0,
  "instrumentFrom": {
    "currencyTitle": "BTC",
    "networkTitle": "BTC",
    "precisionDecimals": 8
  },
  "instrumentTo": {
    "currencyTitle": "USDT",
    "networkTitle": "TRC20",
    "precisionDecimals": 2
  },
  "price": "108.51"
}

Notas

Este método permite calcular a taxa em tempo real antes de criar uma ordem.

Se o valor do depósito for muito baixo, o erro ERR_CLAIMED_DEPOSIT_AMOUNT_TOO_SMALL será retornado.

O parâmetro rateMode pode ser configurado como taxa flutuante ou fixa.

Os parâmetros markup e referrerId são úteis para integrações de parceiros e calculadoras de câmbio personalizadas.

Code Sample

Response Example

Try it out

Compartilhe este artigo:

API V1 Rates