La sección pairs proporciona un método para obtener información sobre un par de divisas específico mediante su identificador.
Este método permite obtener los parámetros del par necesarios para calcular y ejecutar el intercambio.
Documentation
Descripción general
Devuelve información sobre un par de trading específico según la combinación de moneda y red de origen y destino.
Parámetros
Parámetros de consulta (Query)
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
instrumentFromCurrencyTitle |
string | sí | Código de la moneda de origen (por ejemplo, BTC). |
instrumentFromNetworkTitle |
string | sí | Red de la moneda de origen (por ejemplo, BTC para Bitcoin). |
instrumentToCurrencyTitle |
string | sí | Código de la moneda de destino (por ejemplo, USDT). |
instrumentToNetworkTitle |
string | sí | Red de la moneda de destino (por ejemplo, TRC20). |
Encabezados
| Nombre | Requerido | Descripción |
|---|---|---|
X-Api-Public-Key |
sí | Tu clave pública de API. |
X-Api-Timestamp |
sí | Marca de tiempo en formato UNIX (ms). |
X-Api-Signature |
sí | Firma HMAC de la solicitud usando tu clave secreta. |
Ejemplo de solicitud
curl -X GET "https://quickex.io/api/v2/pairs/one?instrumentFromCurrencyTitle=BTC&instrumentFromNetworkTitle=BTC&instrumentToCurrencyTitle=USDT&instrumentToNetworkTitle=TRC20" \ -H "accept: application/json" \ -H "X-Api-Public-Key: yourPublicKey" \ -H "X-Api-Timestamp: 1691399446000" \ -H "X-Api-Signature: yourHmacSignature"
Posibles respuestas
200 OK — información del par devuelta:
{ "minAmountUSDT": 10.0, "maxAmountUSDT": 10000.0, "minAmountXML": 0.001, "maxAmountXML": 100.0, "massEdit": true, "createdAt": "2025-08-07T05:50:46.295Z", "updatedAt": "2025-08-07T05:50:46.295Z", "rateMultiplier": 1.0, "desiredBestChangePosition": 0, "maxCorrectionOfInternalRate_Percentage": "0.0005", "minAmount": "1000.000", "maxAmount": "1000.000", "isActive": true, "enableFixedRate": true, "platformFeeSteps": ["0.5","1.0"], "orderDefault": 1, "liquidityAmount": "1000.000", "fixedRate_maxAmount": "1000.000", "fixedRate_maxTimeMinutes": 1, "fixedRate_maxRateVolatilityPercent": "1000.000" }
500 ERR_UNKNOWN — par no encontrado o error interno del servidor:
{ "status": "ERR_UNKNOWN", "message": "code=404, message=Not Found", "data": null }
Casos de uso
Un integrador muestra en el sitio la lista de pares disponibles. Cuando el usuario selecciona el par BTC→USDT, el frontend necesita obtener los valores mínimos y máximos, el estado de actividad y las condiciones de tarifa fija. Este endpoint se llama al hacer clic, y los resultados se insertan en el formulario de creación de la orden.
Code Sample
curl -X 'GET' \
'https://quickex.io/api/v2/pairs/public' \
-H 'accept: application/json'Response Example
[
{
"instrumentFrom": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"currencyFriendlyTitle": "BTC",
"slug": "btc",
"precisionDecimals": 7,
"reservesAmount": "104.35892",
"instrumentType": "crypto",
"bestChangeCurrencyName": "BTC",
"currencyLogoLink": "https://quickex.io/assets/coins/btc.svg",
"contractAddress": ""
},
"instrumentTo": {
"currencyTitle": "XMR",
"networkTitle": "XMR",
"currencyFriendlyTitle": "XMR",
"slug": "xmr",
"precisionDecimals": 4,
"reservesAmount": "24441.213",
"instrumentType": "crypto",
"bestChangeCurrencyName": "XMR",
"currencyLogoLink": "https://quickex.io/assets/coins/xmr.svg",
"contractAddress": ""
},
"isActive": true,
"minAmount": "",
"maxAmount": ""
},
{
"instrumentFrom": {
"currencyTitle": "TRX",
"networkTitle": "TRX",
"currencyFriendlyTitle": "TRON",
"slug": "trx",
"precisionDecimals": 2,
"reservesAmount": "33984708",
"instrumentType": "crypto",
"bestChangeCurrencyName": "TRX",
"currencyLogoLink": "https://quickex.io/assets/coins/trx.svg",
"contractAddress": ""
},
"instrumentTo": {
"currencyTitle": "SOL",
"networkTitle": "SOL",
"currencyFriendlyTitle": "SOL",
"slug": "sol",
"precisionDecimals": 4,
"reservesAmount": "70192.68",
"instrumentType": "crypto",
"bestChangeCurrencyName": "SOL",
"currencyLogoLink": "https://quickex.io/assets/coins/sol.svg",
"contractAddress": ""
},
"isActive": true,
"minAmount": "",
"maxAmount": ""
}
]Try it out
Leave empty to use default