La section Rates fournit des méthodes pour obtenir les taux de change actuels sur la plateforme Quickex. Un taux est compris comme le rapport entre une devise et une autre au sein d’une paire de trading donnée (par exemple, BTC → USDT).
Ces données permettent de construire des calculateurs d’échange, d’afficher des cotations actualisées à l’utilisateur et de déterminer combien de devise cible sera reçu lors d’un échange. Dans cette section, une méthode est disponible pour obtenir un taux spécifique au format JSON.
Documentation
Description générale
La requête renvoie le calcul d’un taux de change unique pour une paire d’instruments donnée et un montant de dépôt spécifié.
Requête HTTP
Méthode : GET
URL : https://quickex.io/api/v2/rates/public/one
Exemple de requête
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'
Paramètres de la requête
Paramètres de requête (query)
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| instrumentFromCurrencyTitle | string | oui | Code de la devise que l’utilisateur envoie (par ex. BTC). |
| instrumentFromNetworkTitle | string | oui | Réseau de l’instrument source (BTC, ERC20, TRC20). |
| instrumentToCurrencyTitle | string | oui | Code de la devise que l’utilisateur reçoit (par ex. USDT). |
| instrumentToNetworkTitle | string | oui | Réseau de l’instrument de destination (TRC20, ERC20). |
| instrumentFromSlug | string | non | Slug de l’instrument source dans le système Quickex. |
| instrumentToSlug | string | non | Slug de l’instrument de destination. |
| claimedDepositAmountCurrency | string | oui | Code de la devise dans laquelle le montant du dépôt est indiqué. |
| claimedDepositAmount | number | non | Montant que l’utilisateur souhaite envoyer. |
| rateMode | string | non | Mode de taux : fixed ou float. |
| exchangeType | string | oui | Type d’opération : crypto / fiat / stablecoin. |
| referrerId | number | non | Identifiant du partenaire. |
| markup | number | non | Marge du partenaire sur le taux (par ex. 0,01 = +1 %). |
Format de réponse
La méthode renvoie un objet JSON contenant des informations sur la paire sélectionnée, les montants calculés, les taux et les limites.
Exemple de réponse
{
"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
}
Détail des champs de la réponse
Informations sur les instruments
"instrumentFrom": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"slug": "btc",
"precisionDecimals": 7
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"slug": "usdttrc20",
"precisionDecimals": 2
}
</tr >
| Champ | Type | Description |
|---|---|---|
| instrumentFrom | object | Instrument source. |
| instrumentTo | object | Instrument de destination. |
| currencyTitle | string | Code de la devise. |
| networkTitle | string | Réseau. |
| slug | string | Slug de l’instrument. |
| precisionDecimals | number | Nombre de décimales. |
Montants et paramètres clés
"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"
| Champ | Type | Description |
|---|---|---|
| claimedDepositAmount | string | Montant du dépôt demandé par l’utilisateur. |
| amountToGive | string | Montant final à envoyer. |
| amountToGiveCurrencyTitle | string | Devise du montant à envoyer. |
| amountToGet | string | Montant que l’utilisateur recevra. |
| amountToGetUSDT | string | Montant équivalent en USDT. |
| rateMode | string | Mode de taux : fixed ou float. |
| enableFixedRate | boolean | Indique si le taux fixe est disponible. |
| finalNetworkFeeAmount | string | Frais de réseau finaux. |
| generalMinAmount | string | Montant minimal de dépôt possible. |
| generalMaxAmount | string | Montant maximal de dépôt possible. |
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