Dokumentation/API-Referenz

API REFERENCE

Wechselkurs abfragen

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

Wechselkurs abfragen

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.

Diese API fragt Wechselkurse ab.

Bevor Sie einen FX-Auftrag erstellen, müssen Sie diese API aufrufen, um einen Kurs zu erhalten, und den Auftrag innerhalb von 30 Sekunden nach Erhalt des Kurses erstellen.

Hinweise

Tipp

Hinweise

  1. Gültigkeitsdauer des Kurses Jeder zurückgegebene Wechselkurs ist 30 Sekunden gültig. Danach müssen Sie den Wechselkurs erneut abfragen.

  2. Abrechnungslaufzeit (Tenor)

  • TOD: Abrechnung in Echtzeit, unabhängig von Feiertagen.

  • SPOT: Abrechnung an T+2 Geschäftstagen. Stellen Sie vor dem Abrechnungstag sicher, dass das Konto über ausreichend Guthaben für die Abrechnung verfügt. Schlägt die Abrechnung wegen unzureichender Mittel fehl, kann auf Grundlage des tatsächlichen Verlusts eine Gebühr erhoben werden.

  1. SPOT-Zugang Die Nutzung der SPOT-Abrechnung muss im Voraus beantragt werden und unterliegt Kreditlimits.

Verwenden Sie bitte ein dediziertes Konto.

user=040268

ParameterTypBeschreibungErforderlich
userStringHändlerbezogenes UIDErforderlich
signStringSignatureErforderlich
methodStringv3.GetFXQuoteErforderlich
timeLongTimestampErforderlich
  • Parameter
ParameterTypBeschreibungErforderlich
sell_currencyStringZu verkaufende WährungErforderlich
buy_currencyStringZu kaufende WährungErforderlich
currencyStringZu verkaufende Währung, wenn die Währung sell_currency entspricht; andernfalls die zu kaufende WährungErforderlich
amountStringZu verkaufender Betrag, wenn die Währung sell_currency entspricht; andernfalls der zu kaufende BetragErforderlich
tenorStringTOD oder SPOTErforderlich
request_idStringEindeutige Anfrage-ID; empfohlen wird eine Kombination aus mindestens 24 Ziffern und BuchstabenErforderlich

Signaturbeispiel:

Die sortierten Parameter werden zu einer URL-ähnlichen Abfragezeichenfolge verkettet.

"amount=1&buy_currency=DKK&currency=GBP&method=v3.GetFXQuote&request_id=20304095064069023960369000g-42&sell_currency=GBP&tenor=TOD&time=1546588959&user=040268"

Signieren Sie stringA mit secret_key.

Die resultierende Signatur lautet:

"YOUR_SIGNATURE"

Anfragebeispiel:

{
  "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"
  }
}

Antwortbeispiel:

{
  "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"
}

Weitere Informationen:

Antwortergebnis:
  1. Bei erfolgreichem Aufruf wird "status": true zurückgegeben.
  2. Bei fehlgeschlagenem Aufruf wird "status": false zurückgegeben.
Antwortcodes:
StatusCodeMessage
true200
false-1000Internal error
false-403The signature Error
false-2001The UID not exist
false-3001Required field is missing
false-4118Incorrect request ID