Раздел пары (pairs) предоставляет метод для получения информации о конкретной валютной паре по её идентификатору. Метод позволяет получить параметры пары, необходимые для расчёта и выполнения обмена.
Documentation
GET /api/v2/pairs/one
Общее описание
Возвращает информацию о конкретной торговой паре (pair) по комбинации исходной и целевой валют с указанием сети.
Параметры
Query-параметры
| Название | Тип | Обязательное | Описание |
|---|---|---|---|
instrumentFromCurrencyTitle |
string | да | Код исходной валюты (например, BTC). |
instrumentFromNetworkTitle |
string | да | Сеть исходной валюты (например, BTC для биткоина). |
instrumentToCurrencyTitle |
string | да | Код целевой валюты (например, USDT). |
instrumentToNetworkTitle |
string | да | Сеть целевой валюты (например, TRC20). |
Заголовки (Headers)
| Название | Обязательное | Описание |
|---|---|---|
X-Api-Public-Key |
да | Ваш публичный API-ключ. |
X-Api-Timestamp |
да | Метка времени в формате UNIX (ms). |
X-Api-Signature |
да | HMAC-подпись запроса вашим секретным ключом. |
Пример запроса
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"
Возможные ответы
200 OK — информация о паре возвращена.
{
"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 — пара не найдена или внутренняя ошибка сервера.
{
"status": "ERR_UNKNOWN",
"message": "code=404, message=Not Found",
"data": null
}
Use Case
Интегратор отображает список доступных пар на сайте. При выборе пользователем пары BTC→USDT необходимо получить параметры минимальных и максимальных сумм, статусы активности и условия фиксированного курса. Для этого после клика вызывается этот эндпоинт и результаты подставляются в форму создания ордера.
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