The pairs section provides a method for obtaining information about a specific currency pair by its identifier. The method allows you to get the pair parameters necessary for calculating and executing the exchange.
Documentation
General Description
The request returns a list of active trading pairs (exchange directions) available in the Quickex system.
Each pair describes the items that can be exchanged (`instrumentFrom`) for what (`instrumentTo`), along with basic amount limits and current reserves for each side.
HTTP Request
Method: GET
URL: https://quickex.io/api/v2/pairs/public
Request Example
curl -X 'GET' \ 'https://quickex.io/api/v2/pairs/public' \ -H 'accept: application/json'
Request Parameters
Query Parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
instrumentFromCurrencyTitle |
string | Filter by source currency (e.g. BTC). |
No |
instrumentFromNetworkTitle |
string | Filter by source network (e.g. BTC, TRX, ERC20). |
No |
instrumentToCurrencyTitle |
string | Filter by target currency (e.g. USDT). |
No |
instrumentToNetworkTitle |
string | Filter by target network (e.g. TRC20, SOL). |
No |
limit |
number | Maximum number of results to return. | No |
offset |
number | Number of items to skip (used for pagination). | No |
Response Format
The method returns a JSON array where each element is an instrument pair object.
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": ""
},
...
]
Response Field Breakdown
Example of a Pair Object
{
"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": ""
}
Top-level Fields
| Field | Type | Description |
|---|---|---|
instrumentFrom |
object | Source instrument object (what the user gives). |
instrumentTo |
object | Target instrument object (what the user receives). |
isActive |
boolean | The pair is active and available for exchange. |
minAmount |
string | Minimum exchange amount (can be empty). |
maxAmount |
string | Maximum exchange amount (can be empty). |
Instrument Object Fields
| Field | Type | Description |
|---|---|---|
currencyTitle |
string | Currency code (`BTC`, `SOL`, `TRX`). |
networkTitle |
string | Network code (`BTC`, `TRX`, `SOL`, `ERC20`, `TRC20`). |
currencyFriendlyTitle |
string | Human-readable currency name. |
slug |
string | Instrument slug. |
precisionDecimals |
number | Number of decimal places. |
reservesAmount |
string | Available coin reserve. |
instrumentType |
string | Instrument type (`crypto`). |
bestChangeCurrencyName |
string | Name in BestChange. |
currencyLogoLink |
string | Currency logo. |
contractAddress |
string | Smart contract address or empty string. |
Possible Use Cases
- Preloading the list of pairs for caching.
- Building a list of exchange directions.
- Filtering pairs for UI.
- Using limits and reserves to validate amounts.
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
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).