Documentatie/API-referentie

API REFERENCE

Wisselkoers opvragen

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

Wisselkoers opvragen

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.

Deze API vraagt wisselkoersen op.

Voordat u een FX-order aanmaakt, moet u deze API aanroepen om een koers op te halen. Maak de order vervolgens binnen 30 seconden na ontvangst van de koers aan.

Opmerkingen

Tip

Opmerkingen

  1. Geldigheidsduur van de koers
    Elke geretourneerde wisselkoers is 30 seconden geldig. Vraag de wisselkoers opnieuw op nadat deze is verlopen.

  2. Afwikkelingstermijn (Tenor)

  • TOD: Afwikkeling in realtime, niet beïnvloed door feestdagen.

  • SPOT: Afwikkeling op T+2 werkdagen. Zorg vóór de afwikkelingsdatum voor voldoende saldo op de rekening. Als de afwikkeling door onvoldoende saldo mislukt, kan op basis van het werkelijke verlies een boete in rekening worden gebracht.

  1. Toegang tot SPOT
    U moet vooraf SPOT-afwikkeling aanvragen; hiervoor gelden kredietlimieten.

Gebruik een speciaal account.

user=040268

API-URL:https://mapi.yabandpay.com/Payments

Methode:POST

POST gegevenstype:Json

ParameterTypeBeschrijvingVerplicht
userStringMerchantniveau UIDVerplicht
signStringSignatureVerplicht
methodStringv3.GetFXQuoteVerplicht
timeLongTimestampVerplicht
  • Parameters
ParameterTypeBeschrijvingVerplicht
sell_currencyStringTe verkopen valutaVerplicht
buy_currencyStringTe kopen valutaVerplicht
currencyStringTe verkopen valuta als de valuta overeenkomt met sell_currency; anders de te kopen valutaVerplicht
amountStringTe verkopen bedrag als de valuta overeenkomt met sell_currency; anders het te kopen bedragVerplicht
tenorStringTOD of SPOTVerplicht
request_idStringUnieke aanvraag-ID; een combinatie van minimaal 24 cijfers en letters wordt aanbevolenVerplicht

Voorbeeld van een handtekening:

Parameters op volgorde samengevoegd tot een querystring in URL-stijl

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

Onderteken stringA met secret_key

De gegenereerde handtekening is:

"YOUR_SIGNATURE"

Voorbeeld van een aanvraag:

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

Voorbeeld van een antwoord:

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

Aanvullende informatie:

Resultaat van het antwoord:
  1. Bij een geslaagde aanroep wordt "status": true geretourneerd.
  2. Bij een mislukte aanroep wordt "status": false geretourneerd.
Antwoordcodes:
StatusCodeBericht
true200
false-1000Internal error
false-403The signature Error
false-2001The UID not exist
false-3001Required field is missing
false-4118Incorrect request ID