Documentation/Référence API

API REFERENCE

Consulter le taux de change

POSThttps://mapi.yabandpay.com/Payments
Live API
API PLAYGROUND · Live API

Consulter le taux de change

POSThttps://mapi.yabandpay.com/Payments
Automatically signed with your credentials

Request parameters6

Required fields first

汇率查询

sell_currencyRequiredstringdata.sell_currency卖出货币
buy_currencyRequiredstringdata.buy_currency买入货币
currencyRequiredstringdata.currency卖出货币,currency如果和sell_currency相同则为卖出货币,否则为买入货币
amountRequiredstringdata.amount卖出货币金额,currency如果和sell_currency相同则为卖出货币金额,否则为买入货币金额
tenorRequiredstringdata.tenorTOD 或者 SPOT
request_idRequiredstringdata.request_id请求id需保持唯一,建议24以上位数字+字母

Credentials stay on this page. Your secret key is never stored or sent to the documentation server.

Paramètres

ParameterTypeDescriptionObligatoire
data.sell_currencystring卖出货币✓
data.buy_currencystring买入货币✓
data.currencystring卖出货币,currency如果和sell_currency相同则为卖出货币,否则为买入货币✓
data.amountstring卖出货币金额,currency如果和sell_currency相同则为卖出货币金额,否则为买入货币金额✓
data.tenorstringTOD 或者 SPOT✓
data.request_idstring请求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

  1. 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.

  2. É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.

  1. 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ètreTypeDescriptionObligatoire
userStringUID au niveau du marchandObligatoire
signStringSignatureObligatoire
methodStringv3.GetFXQuoteObligatoire
timeLongTimestampObligatoire
  • 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&currency=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 :
  1. Si l’appel réussit, "status": true est renvoyé.
  2. Si l’appel échoue, "status": false est renvoyé.
Codes de réponse :
StatusCodeMessage
true200
false-1000Internal error
false-403The signature Error
false-2001The UID not exist
false-3001Required field is missing
false-4118Incorrect request ID