The Rates section provides methods for obtaining actual exchange rates on the Quickex platform. A rate is understood as the ratio of one currency to another within a certain trading pair (for example, BTC → USDT).
This data allows you to build exchange calculators, display actual quotes to the user, and determine how much of the target currency you will receive when exchanging. In this section, a method is available for obtaining one specific rate in JSON format.
Documentation
General Description
The request returns the calculation of a single exchange rate for a given pair of instruments and deposit amount.
HTTP Request
Method: GET
URL: https://quickex.io/api/v2/rates/public/one
Request Example
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'
Request Parameters
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| instrumentFromCurrencyTitle | string | yes | The currency code the user gives (e.g., BTC). |
| instrumentFromNetworkTitle | string | yes | Network of the source instrument (BTC, ERC20, TRC20). |
| instrumentToCurrencyTitle | string | yes | The currency code the user receives (e.g., USDT). |
| instrumentToNetworkTitle | string | yes | Network of the target instrument (TRC20, ERC20). |
| instrumentFromSlug | string | no | Slug of the source instrument within Quickex system (btc). |
| instrumentToSlug | string | no | Slug of the target instrument (usdttrc20). |
| claimedDepositAmountCurrency | string | yes | Currency code in which the deposit amount is specified. |
| claimedDepositAmount | number | no | Amount the user intends to send. |
| rateMode | string | no | Rate mode: fixed or float. |
| exchangeType | string | yes | Operation type: crypto / fiat / stablecoin. |
| referrerId | number | no | Partner ID. |
| markup | number | no | Partner’s markup on the rate (%). |
Response Format
The method returns a JSON object with information about the selected pair, calculated amounts, rates, and limits.
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
}
Response Fields Breakdown
Instrument Information
"instrumentFrom": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"slug": "btc",
"precisionDecimals": 7
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"slug": "usdttrc20",
"precisionDecimals": 2
}
| Field | Type | Description |
|---|---|---|
| instrumentFrom | object | Source instrument. |
| instrumentTo | object | Target instrument. |
| currencyTitle | string | Currency code. |
| networkTitle | string | Network. |
| slug | string | Instrument slug. |
| precisionDecimals | number | Number of decimal places. |
Amounts and Key Parameters
"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"
| Field | Type | Description |
|---|---|---|
| claimedDepositAmount | string | Deposit amount requested by the user. |
| amountToGive | string | Final amount to send. |
| amountToGiveCurrencyTitle | string | Currency of the amount to send. |
| amountToGet | string | Amount the user will receive. |
| amountToGetUSDT | string | Equivalent amount in USDT. |
| rateMode | string | Rate mode: fixed or float. |
| enableFixedRate | boolean | Is fixed rate available. |
| finalNetworkFeeAmount | string | Final network fee. |
| generalMinAmount | string | Minimum possible deposit. |
| generalMaxAmount | string | Maximum possible deposit. |
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