API REFERENCE

Consultar a taxa de câmbio

YabandPay documentation·Atualizado em 26 de out. de 2026

Parâmetros

Parameter	Type	Descrição	Obrigatório
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以上位数字+字母	✓

Esta API consulta taxas de câmbio.

Antes de criar uma ordem de câmbio, chame esta API para obter uma cotação e crie a ordem em até 30 segundos após recebê-la.

Observações

Dica

Observações

Período de validade da cotação
Cada cotação de taxa de câmbio retornada é válida por 30 segundos. Após expirar, consulte novamente a taxa de câmbio.

Prazo de liquidação (Tenor)

TOD: liquidação em tempo real, não afetada por feriados.

SPOT: liquidação em T+2 dias úteis. Antes da data de liquidação, certifique-se de que a conta tenha fundos suficientes para a liquidação. Se a liquidação falhar por insuficiência de fundos, poderá ser cobrada uma penalidade com base na perda efetiva.

Acesso a SPOT
É necessário solicitar previamente o uso da liquidação SPOT, sujeita a limites de crédito.

Use uma conta dedicada.

user=040268

Parâmetro	Tipo	Descrição	Obrigatório
user	String	UID no nível do estabelecimento	Obrigatório
sign	String	Signature	Obrigatório
method	String	v3.GetFXQuote	Obrigatório
time	Long	Timestamp	Obrigatório

Parameters

Parâmetro	Tipo	Descrição	Obrigatório
sell_currency	String	Moeda a vender	Obrigatório
buy_currency	String	Moeda a comprar	Obrigatório
currency	String	Moeda a vender se a moeda corresponder a sell_currency; caso contrário, moeda a comprar	Obrigatório
amount	String	Valor a vender se a moeda corresponder a sell_currency; caso contrário, valor a comprar	Obrigatório
tenor	String	TOD ou SPOT	Obrigatório
request_id	String	ID de solicitação exclusivo; recomenda-se uma combinação de pelo menos 24 letras e números	Obrigatório

Signature example:

Parâmetros ordenados concatenados em uma cadeia de consulta no 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"

Sign stringA using secret_key

A assinatura resultante é:

"YOUR_SIGNATURE"

Request example:

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

Response example:

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

Additional information:

Response result:

Se a chamada for bem-sucedida, "status": true será retornado.
Se a chamada falhar, "status": false será retornado.

Response codes:

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

Consultar a taxa de câmbio

Consultar a taxa de câmbio

Request parameters6

汇率查询

Parâmetros

Signature example:

Request example:

Response example:

Additional information:

Response result:

Response codes: