La sección Rates proporciona métodos para obtener los tipos de cambio reales en la plataforma Quickex. Por tipo de cambio se entiende la relación entre una moneda y otra dentro de un par de negociación determinado (por ejemplo, BTC → USDT).
Estos datos permiten construir calculadoras de intercambio, mostrar cotizaciones actualizadas al usuario y determinar cuánto de la moneda de destino recibirás al realizar el cambio. En esta sección hay disponible un método para obtener un tipo de cambio específico en formato JSON.
Documentation
Descripción general
La solicitud devuelve el cálculo de un único tipo de cambio para un par de instrumentos y un importe de depósito determinados.
Solicitud HTTP
Método: GET
URL: https://quickex.io/api/v2/rates/public/one
Ejemplo de solicitud
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 de la solicitud
Parámetros de consulta
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| instrumentFromCurrencyTitle | string | sí | Código de la moneda que entrega el usuario (por ejemplo, BTC). |
| instrumentFromNetworkTitle | string | sí | Red del instrumento de origen (BTC, ERC20, TRC20, etc.). |
| instrumentToCurrencyTitle | string | sí | Código de la moneda que recibe el usuario (por ejemplo, USDT). |
| instrumentToNetworkTitle | string | sí | Red del instrumento de destino (TRC20, ERC20, etc.). |
| instrumentFromSlug | string | no | Slug del instrumento de origen dentro del sistema Quickex. |
| instrumentToSlug | string | no | Slug del instrumento de destino. |
| claimedDepositAmountCurrency | string | sí | Código de la moneda en la que se especifica el importe del depósito. |
| claimedDepositAmount | number | no | Importe que el usuario piensa enviar. |
| rateMode | string | no | Modo del tipo de cambio: fixed o float. |
| exchangeType | string | sí | Tipo de operación: crypto / fiat / stablecoin. |
| referrerId | number | no | ID del socio (partner). |
| markup | number | no | Markup del socio sobre el tipo de cambio (%). |
Formato de respuesta
El método devuelve un objeto JSON con información sobre el par seleccionado, los importes calculados, los tipos de cambio y los límites.
Ejemplo de respuesta
{
"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
}
Desglose de campos de la respuesta
Información del instrumento
"instrumentFrom": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"slug": "btc",
"precisionDecimals": 7
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"slug": "usdttrc20",
"precisionDecimals": 2
}
</tr >
| Campo | Tipo | Descripción |
|---|---|---|
| instrumentFrom | object | Instrumento de origen. |
| instrumentTo | object | Instrumento de destino. |
| currencyTitle | string | Código de la moneda. |
| networkTitle | string | Red. |
| slug | string | Slug del instrumento. |
| precisionDecimals | number | Número de decimales. |
Importes y parámetros clave
"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 | Descripción |
|---|---|---|
| claimedDepositAmount | string | Importe de depósito solicitado por el usuario. |
| amountToGive | string | Importe final a enviar. |
| amountToGiveCurrencyTitle | string | Moneda del importe a enviar. |
| amountToGet | string | Importe que recibirá el usuario. |
| amountToGetUSDT | string | Importe equivalente en USDT. |
| rateMode | string | Modo del tipo de cambio: fixed o float. |
| enableFixedRate | boolean | Indica si el tipo fijo está disponible. |
| finalNetworkFeeAmount | string | Comisión final de red. |
| generalMinAmount | string | Depósito mínimo posible. |
| generalMaxAmount | string | Depósito máximo posible. |
Code Sample
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=sell' \
-H 'accept: application/json'Response Example
{
"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
}Try it out
Leave empty to use default