RatesQuickex Exchange Rates: Retrieval and Calculation

Equipo Quickex

17 de noviembre de 2025

~1 lectura mínima

La sección de Rates proporciona métodos para obtener los tipos de cambio actuales en la plataforma Quickex.
Un tipo de cambio se entiende como la relación entre una moneda y otra dentro de un determinado par de trading
(por ejemplo, BTC → USDT).

Estos datos permiten crear calculadoras de intercambio, mostrar cotizaciones actuales al usuario
y determinar cuánto de la moneda destino recibirás al realizar el intercambio.
En esta sección está disponible un método para obtener un tipo de cambio específico en formato JSON.

GET

public/one

Endpoint URL

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

Documentation

Devuelve el tipo de cambio público actual para el par de trading especificado.
Este método se utiliza para calcular una dirección de intercambio concreta, teniendo en cuenta el monto ingresado, el modo de tasa y los parámetros adicionales.

URL

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

Parámetros de consulta (Query)

Parámetro	Tipo	Requerido	Descripción
`exchangeType`	string	sí	Tipo de intercambio (por ejemplo, `crypto`).
`instrumentFromCurrencyTitle`	string	sí	Moneda de origen (por ejemplo, `BTC`).
`instrumentFromNetworkTitle`	string	sí	Red de la moneda de origen (por ejemplo, `BTC` o `ERC20`).
`instrumentToCurrencyTitle`	string	sí	Moneda de destino (por ejemplo, `USDT`).
`instrumentToNetworkTitle`	string	sí	Red de la moneda de destino (por ejemplo, `TRC20`).
`claimedDepositAmount`	string	no	Monto del depósito para el cálculo de la tasa.
`rateMode`	string	no	Modo de tasa: `FLOATING` (flotante) o `FIXED` (fija).
`claimedDepositAmountCurrency`	string	sí	Moneda en la que se especifica el monto del depósito (por ejemplo, `USDT`).
`markup`	string	no	Recargo aplicado a la tasa (por ejemplo, `1.00`).
`referrerId`	string	no	Identificador del socio/afiliado (por ejemplo, `aff_some-affiliate-id`).

Ejemplo de solicitud (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'

Ejemplo de respuesta (422 — error)

{
  "status": "ERR_CLAIMED_DEPOSIT_AMOUNT_TOO_SMALL",
  "message": "Claimed Deposit Amount Too Small Error",
  "data": {
    "localizedMessage": "El monto declarado es 1. El monto mínimo procesable es 108.51",
    "details": {
      "field": "claimedDepositAmount",
      "value": "1",
      "expected": "108.51",
      "expectedGeneral": "108.51"
    }
  }
}

Ejemplo de respuesta (200 — éxito)

{
  "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 la tasa en tiempo real antes de crear una orden.

Si el monto del depósito es demasiado pequeño, se devolverá el error ERR_CLAIMED_DEPOSIT_AMOUNT_TOO_SMALL.

El parámetro rateMode puede establecerse en tasa flotante o fija.

Los parámetros markup y referrerId son útiles para integraciones de socios y calculadoras de intercambio personalizadas.

Code Sample

Response Example

Try it out

Comparte este artículo:

API V1 Rates