Rates API V2

Equipe Quickex

12 de dezembro de 2025

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

Esses dados permitem construir calculadoras de câmbio, exibir cotações reais para o usuário e determinar quanto da moeda de destino você receberá ao efetuar a troca. Nesta seção, está disponível um método para obter uma taxa específica em formato JSON.

GET

rates/public/one

Endpoint URL

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

Documentation

Descrição geral

A requisição retorna o cálculo de uma única taxa de câmbio para um determinado par de instrumentos e valor de depósito.

Requisição HTTP

Método: GET
URL: https://quickex.io/api/v2/rates/public/one

Exemplo de requisição

curl -X GET \
 'https://quickex.io/api/v2/rates/public/one
  ?instrumentFromCurrencyTitle=BTC
  &instrumentFromNetworkTitle=BTC
  &instrumentToCurrencyTitle=USDT
  &instrumentToNetworkTitle=TRC20
  &instrumentFromSlug=btc
  &instrumentToSlug=usdttrc20
  &claimedDepositAmountCurrency=BTC
  &rateMode=fixed
  &referrerId=123
  &claimedDepositAmount=0.082539
  &markup=0.0
  &exchangeType=crypto' \
-H 'accept: application/json'

Parâmetros da requisição

Parâmetros de query

Parâmetro	Tipo	Obrigatório	Descrição
instrumentFromCurrencyTitle	string	sim	Código da moeda que o usuário envia (por exemplo, BTC).
instrumentFromNetworkTitle	string	sim	Rede do instrumento de origem (BTC, ERC20, TRC20).
instrumentToCurrencyTitle	string	sim	Código da moeda que o usuário recebe (por exemplo, USDT).
instrumentToNetworkTitle	string	sim	Rede do instrumento de destino (TRC20, ERC20).
instrumentFromSlug	string	não	Slug do instrumento de origem dentro do sistema Quickex.
instrumentToSlug	string	não	Slug do instrumento de destino.
claimedDepositAmountCurrency	string	sim	Código da moeda na qual o valor do depósito é especificado.
claimedDepositAmount	number	não	Valor que o usuário pretende enviar.
rateMode	string	não	Modo da taxa: fixed ou float.
exchangeType	string	sim	Tipo de operação: crypto / fiat / stablecoin.
referrerId	number	não	ID do parceiro.
markup	number	não	Markup do parceiro sobre a taxa (por exemplo, 0.01 = +1%).

Formato da resposta

O método retorna um objeto JSON com informações sobre o par selecionado, valores calculados, taxas e limites.

Exemplo de resposta

{
  "instrumentFrom": {
    "currencyTitle": "BTC",
    "networkTitle": "BTC",
    "slug": "btc",
    "precisionDecimals": 7
  },
  "instrumentTo": {
    "currencyTitle": "USDT",
    "networkTitle": "TRC20",
    "slug": "usdttrc20",
    "precisionDecimals": 2
  },
  "claimedDepositAmount": "0.082539",
  "depositRules": null,
  "platformFee_Absolute": "",
  "withdrawalRules": null,
  "minConfirmationsToWithdraw": 3,
  "minConfirmationsToTrade": 3,
  "updatedAt": 1764661006130,
  "liquidityProviderPublicCode": "hat",
  "amountToGet": "7031.14",
  "amountToGetUSDT": "7031.148333816",
  "amountToGive": "0.082539",
  "marketMinAmount": "",
  "enableFixedRate": true,
  "ckms": false,
  "ckm": "D",
  "amountToGiveCurrencyTitle": "BTC",
  "rateMode": "fixed",
  "finalNetworkFeeAmount": "1.5",
  "liquidityProviderQuotes": {
    "sellQuote": {
      "baseValue": "1",
      "quoteValue": "86942.8"
    },
    "buyQuote": {
      "baseValue": "86942.9",
      "quoteValue": "1"
    }
  },
  "price": "85185.7707727983133388",
  "leftPrice": "85185.7707727983133388",
  "rightPrice": "0.0000112693615569",
  "marketLeftPrice": "86942.8",
  "marketRightPrice": "0.0000115018017572",
  "marketAmountToGet": "7176.1717692",
  "marketAmountToGetUSDT": "7176.1717692",
  "quotesWithoutNetworkFee": {
    "sellQuote": {
      "baseValue": "1",
      "quoteValue": "85203.944"
    },
    "buyQuote": {
      "baseValue": "86942.9",
      "quoteValue": "0.98"
    }
  },
  "quotes": {
    "sellQuote": {
      "baseValue": "1",
      "quoteValue": "85185.77077279831333884"
    },
    "buyQuote": {
      "baseValue": "86942.9",
      "quoteValue": "0.9797909749030203"
    }
  },
  "generalMinAmount": "0.0011501",
  "generalMaxAmount": "0.09171",
  "debugInfo": null
}

Detalhamento dos campos da resposta

Informações do instrumento

"instrumentFrom": {
  "currencyTitle": "BTC",
  "networkTitle": "BTC",
  "slug": "btc",
  "precisionDecimals": 7
},
"instrumentTo": {
  "currencyTitle": "USDT",
  "networkTitle": "TRC20",
  "slug": "usdttrc20",
  "precisionDecimals": 2
}

</tr >

Campo	Tipo	Descrição
instrumentFrom	object	Instrumento de origem.
instrumentTo	object	Instrumento de destino.
currencyTitle	string	Código da moeda.
networkTitle	string	Rede.
slug	string	Slug do instrumento.
precisionDecimals	number	Número de casas decimais.

Valores e parâmetros principais

"claimedDepositAmount": "0.082539",
"amountToGive": "0.082539",
"amountToGiveCurrencyTitle": "BTC",
"amountToGet": "7031.14",
"amountToGetUSDT": "7031.148333816",
"rateMode": "fixed",
"enableFixedRate": true,
"finalNetworkFeeAmount": "1.5",
"generalMinAmount": "0.0011501",
"generalMaxAmount": "0.09171"

Campo	Tipo	Descrição
claimedDepositAmount	string	Valor de depósito solicitado pelo usuário.
amountToGive	string	Valor final a ser enviado.
amountToGiveCurrencyTitle	string	Moeda do valor a ser enviado.
amountToGet	string	Valor que o usuário receberá.
amountToGetUSDT	string	Valor equivalente em USDT.
rateMode	string	Modo da taxa: fixed ou float.
enableFixedRate	boolean	Indica se a taxa fixa está disponível.
finalNetworkFeeAmount	string	Taxa de rede final.
generalMinAmount	string	Depósito mínimo possível.
generalMaxAmount	string	Depósito máximo possível.

Code Sample

Response Example

Try it out

Compartilhe este artigo: