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 créer des calculateurs d’échange, d’afficher les cotations actuelles à l’utilisateur
et de déterminer combien de la devise cible vous recevrez lors de l’échange.
Dans cette section, une méthode est disponible pour obtenir un taux spécifique au format JSON.
Documentation
Retourne le taux de change public actuel pour la paire de trading spécifiée.
Cette méthode est utilisée pour calculer une direction d’échange spécifique, en tenant compte du montant saisi, du mode de taux et des paramètres supplémentaires.
URL
https://quickex.io/api/v1/rates/public/one
Paramètres de la requête (Query)
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
exchangeType |
string | oui | Type d’échange (par exemple crypto). |
instrumentFromCurrencyTitle |
string | oui | Devise source (par exemple BTC). |
instrumentFromNetworkTitle |
string | oui | Réseau de la devise source (par exemple BTC ou ERC20). |
instrumentToCurrencyTitle |
string | oui | Devise cible (par exemple USDT). |
instrumentToNetworkTitle |
string | oui | Réseau de la devise cible (par exemple TRC20). |
claimedDepositAmount |
string | non | Montant du dépôt utilisé pour le calcul du taux. |
rateMode |
string | non | Mode du taux : FLOATING (flottant) ou FIXED (fixe). |
claimedDepositAmountCurrency |
string | oui | Devise dans laquelle le montant du dépôt est exprimé (par exemple USDT). |
markup |
string | non | Majoration du taux (par exemple 1.00). |
referrerId |
string | non | Identifiant partenaire / référent (par exemple aff_some-affiliate-id). |
Exemple de requête (cURL)
curl -X GET \
'https://quickex.io/api/v1/rates/public/one?exchangeType=crypto&instrumentFromCurrencyTitle=BTC&instrumentFromNetworkTitle=BTC&instrumentToCurrencyTitle=USDT&instrumentToNetworkTitle=TRC20&claimedDepositAmount=1.00&rateMode=FLOATING&claimedDepositAmountCurrency=USDT&markup=1.00&referrerId=aff_some-affiliate-id' \
-H 'Accept: application/json'
Exemple de réponse (422 — erreur)
{
"status": "ERR_CLAIMED_DEPOSIT_AMOUNT_TOO_SMALL",
"message": "Claimed Deposit Amount Too Small Error",
"data": {
"localizedMessage": "Le montant saisi est 1. Le montant minimum traitable est 108.51",
"details": {
"field": "claimedDepositAmount",
"value": "1",
"expected": "108.51",
"expectedGeneral": "108.51"
}
}
}
Exemple de réponse (200 — succès)
{
"depositRules": {
"minAmount": "1000.1",
"maxAmount": "1000.1"
},
"withdrawalRules": {
"minAmount": "1000.1",
"maxAmount": "1000.1",
"withdrawalFeeRules": {
"minAmount": "1000.1",
"maxAmount": "1000.1"
}
},
"minConfirmationsToWithdraw": 0,
"minConfirmationsToTrade": 0,
"instrumentFrom": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"precisionDecimals": 8
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"precisionDecimals": 2
},
"price": "108.51"
}
Notes
- Cette méthode permet de calculer le taux en temps réel avant de créer un ordre.
- Si le montant du dépôt est trop faible, l’erreur
ERR_CLAIMED_DEPOSIT_AMOUNT_TOO_SMALLsera renvoyée.- Le paramètre
rateModepeut être configuré en taux flottant ou fixe.- Les paramètres
markupetreferrerIdsont utiles pour les intégrations partenaires et les calculateurs d’échange personnalisés.
Code Sample
curl -X 'GET' \
'https://quickex.io/api/v1/rates/public/one?exchangeType=crypto&instrumentFromCurrencyTitle=BTC&instrumentFromNetworkTitle=BTC&instrumentToCurrencyTitle=USDT&instrumentToNetworkTitle=TRC20&claimedDepositAmount=1.00&rateMode=FLOATING&claimedDepositAmountCurrency=USDT&markup=1.00&referrerId=aff_some-affiliate-id' \
-H 'accept: application/json'Response Example
{
"depositRules": {
"minAmount": "1000.1",
"maxAmount": "1000.1"
},
"withdrawalRules": {
"minAmount": "1000.1",
"maxAmount": "1000.1",
"withdrawalFeeRules": {
"minAmount": "1000.1",
"maxAmount": "1000.1"
}
},
"minConfirmationsToWithdraw": 0,
"minConfirmationsToTrade": 0,
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"precisionDecimals": 8
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"precisionDecimals": 8
},
"updatedAt": "2025-08-22T06:45:34.011Z",
"liquidityProviderPublicCode": "formulae",
"amountToGet": "0.1",
"amountToGetUSDT": "0.1",
"amountToGive": "0.1",
"marketMinAmount": "0.1",
"liquidityProviderQuotes": {
"sellQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
},
"buyQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
}
},
"quotesWithoutNetworkFee": {
"sellQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
},
"buyQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
}
},
"price": "0.1",
"quotes": {
"sellQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
},
"buyQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
}
},
"noKycThreshold": "0.1",
"platformFee_Absolute": "0.1",
"marketLeftPrice": "0.1",
"marketRightPrice": "0.1",
"marketAmountToGet": "0.1",
"marketAmountToGetUSDT": "0.1",
"claimedDepositAmount": "0.1"
}Try it out
Leave empty to use default
Query Parameters
Type d’échange (par exemple, crypto).
Devise source (par exemple, BTC).
Réseau de la devise source (par exemple, BTC ou ERC20).
Devise cible (par exemple, USDT).
Réseau de la devise cible (par exemple, TRC20).
Montant du dépôt utilisé pour le calcul du taux.
Mode du taux : FLOATING ou FIXED.
Devise dans laquelle le montant du dépôt est indiqué (par exemple, USDT).
Valeur de la majoration appliquée au taux (par exemple, 1.00).
Identifiant du partenaire/référent (par exemple, aff_some-affiliate-id).