API REFERENCE
Consulter le taux de change
Paramètres
| Parameter | Type | Description | Obligatoire |
|---|---|---|---|
| data.sell_currency | string | 卖出货币 | ✓ |
| data.buy_currency | string | 买入货币 | ✓ |
| data.currency | string | 卖出货币,currency如果和sell_currency相同则为卖出货币,否则为买入货币 | ✓ |
| data.amount | string | 卖出货币金额,currency如果和sell_currency相同则为卖出货币金额,否则为买入货币金额 | ✓ |
| data.tenor | string | TOD 或者 SPOT | ✓ |
| data.request_id | string | 请求id需保持唯一,建议24以上位数字+字母 | ✓ |
Cette API consulte les taux de change.
Avant de créer un ordre de change, vous devez appeler cette API afin d’obtenir une cotation, puis créer l’ordre dans les 30 secondes suivant la réception de la cotation.
Remarques
Conseil
Remarques
Durée de validité de la cotation
Chaque cotation renvoyée est valable pendant 30 secondes. Après son expiration, vous devez consulter de nouveau le taux de change.Échéance de règlement (Tenor)
TOD : règlement en temps réel, sans incidence des jours fériés.
SPOT : règlement à T+2 jours ouvrés. Avant la date de règlement, assurez-vous que le compte dispose de fonds suffisants. En cas d’échec du règlement pour insuffisance de fonds, des pénalités peuvent être appliquées selon le préjudice réel.
- Accès SPOT
Vous devez demander à l’avance l’accès au règlement SPOT, soumis à des limites de crédit.
Veuillez utiliser un compte dédié.
user=040268
| Paramètre | Type | Description | Obligatoire |
|---|---|---|---|
| user | String | UID au niveau du marchand | Obligatoire |
| sign | String | Signature | Obligatoire |
| method | String | v3.GetFXQuote | Obligatoire |
| time | Long | Timestamp | Obligatoire |
- Parameters | Paramètre | Type | Description | Obligatoire | |:--------------|:--- |:----------------------------------------------|:-----| | sell_currency | String | Devise à vendre | Obligatoire | | buy_currency | String | Devise à acheter | Obligatoire | | currency | String | Devise à vendre si elle correspond à sell_currency ; sinon, devise à acheter | Obligatoire | | amount | String | Montant à vendre si la devise correspond à sell_currency ; sinon, montant à acheter | Obligatoire | | tenor | String | TOD ou SPOT | Obligatoire | | request_id | String | ID de requête unique ; une combinaison d’au moins 24 chiffres et lettres est recommandée | Obligatoire |
Exemple de signature :
Paramètres triés et concaténés dans une chaîne de requête au format URL
"amount=1&buy_currency=DKK¤cy=GBP&method=v3.GetFXQuote&request_id=20304095064069023960369000g-42&sell_currency=GBP&tenor=TOD&time=1546588959&user=040268"
Signer stringA avec secret_key
La signature obtenue est :
"YOUR_SIGNATURE"
Exemple de requête :
{
"user": "040268",
"sign": "YOUR_SIGNATURE",
"method": "v3.GetFXQuote",
"time": 1546588959,
"data": {
"sell_currency": "GBP",
"buy_currency": "DKK",
"currency": "GBP",
"amount": "1",
"tenor": "TOD",
"request_id": "20304095064069023960369000g-42"
}
}
Exemple de réponse :
{
"status": true,
"code": "200",
"data": {
"type": "sell",
"sell_currency": "GBP",
"buy_currency": "DKK",
"sold_currency": "GBP",
"sold_amount": "1.00",
"bought_currency": "DKK",
"bought_amount": "8.54",
"tenor": "TOD",
"exchange_rate": 8.544924729,
"quote_id": "83e96dc0-8f8e-48c7-9bc4-6acc1019fced",
"expiry_time": 1773824647
},
"message": "",
"response_id": "202603181703362736334439"
}
Informations complémentaires :
Résultat de la réponse :
- Si l’appel réussit, "status": true est renvoyé.
- Si l’appel échoue, "status": false est renvoyé.
Codes de réponse :
| Status | Code | Message |
|---|---|---|
| true | 200 | |
| false | -1000 | Internal error |
| false | -403 | The signature Error |
| false | -2001 | The UID not exist |
| false | -3001 | Required field is missing |
| false | -4118 | Incorrect request ID |
