Documentación/Referencia de API

API REFERENCE

Consultar el tipo de cambio

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

Consultar el tipo de cambio

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.

Parámetros

ParameterTypeDescripciónObligatorio
data.sell_currencystring卖出货币✓
data.buy_currencystring买入货币✓
data.currencystring卖出货币,currency如果和sell_currency相同则为卖出货币,否则为买入货币✓
data.amountstring卖出货币金额,currency如果和sell_currency相同则为卖出货币金额,否则为买入货币金额✓
data.tenorstringTOD 或者 SPOT✓
data.request_idstring请求id需保持唯一,建议24以上位数字+字母✓

Esta API consulta los tipos de cambio.

Antes de crear una orden de cambio de divesas, debe llamar a esta API para obtener una cotización y crear la orden en un plazo de 30 segundos desde que reciba la cotización.

Notes

Consejo

Notes

  1. Periodo de validez de la cotización
    Cada cotización del tipo de cambio devuelta es válida durante 30 seconds. Una vez caducada, deberá volver a consultar el tipo de cambio.

  2. Plazo de liquidación (Tenor)

  • TOD: Liquidación en tiempo real, sin afectación por festivos.

  • SPOT: Liquidación en T+2 días hábiles. Antes de la fecha de liquidación, asegúrese de que la cuenta tenga fondos suficientes. Si la liquidación falla por falta de fondos, se podrá aplicar una penalización en función de la pérdida real.

  1. SPOT access
    Debe solicitar con antelación el uso de SPOT la liquidación, sujeta a límites de crédito.

Utilice una cuenta específica.

user=040268

ParámetroTipoDescripciónObligatorio
userStringA nivel de comercio UIDObligatorio
signStringSignatureObligatorio
methodStringv3.GetFXQuoteObligatorio
timeLongTimestampObligatorio
  • Parámetros
ParámetroTipoDescripciónObligatorio
sell_currencyStringCurrency to sellObligatorio
buy_currencyStringCurrency to buyObligatorio
currencyStringCurrency to sell if currency matches sell_currency; otherwese, the currency to buyObligatorio
amountStringAmount to sell if currency matches sell_currency; otherwese, the amount to buyObligatorio
tenorStringTOD or SPOTObligatorio
request_idStringID de solicitud único; se recomienda una combinación de al menos 24 dígitos y letrasObligatorio

Ejemplo de firma:

Parámetros ordenados y concatenados en una cadena de consulta con formato de URL

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

Firme la cadena A con secret_key

La firma resultante es:

"YOUR_SIGNATURE"

Ejemplo de solicitud:

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

Ejemplo de respuesta:

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

Información adicional:

Resultado de la respuesta:
  1. Si la llamada se realiza correctamente, se devuelve "status": true es returned.
  2. Si la llamada falla, se devuelve "status": false es returned.
Códigos de respuesta:
StatusCodeMessage
true200
false-1000Internal error
false-403The signature Error
false-2001The UID not exist
false-3001Required field is missing
false-4118Incorrect request ID