Раздел пары (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://dxspot.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://dxspot.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://dxspot.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://dxspot.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://dxspot.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://dxspot.io/assets/coins/sol.svg",
"contractAddress": ""
},
"isActive": true,
"minAmount": "",
"maxAmount": ""
}
]Try it out
Leave empty to use default
Query Parameters
Filter by source currency (e.g. BTC).
Filter by source network (e.g. BTC, TRX, ERC20).
Filter by target currency (e.g. USDT).
Filter by target network (e.g. TRC20, SOL).
Maximum number of results to return.
Number of items to skip (used for pagination).