API REFERENCE
Consultar el tipo de cambio
Parámetros
| Parameter | Type | Descripción | Obligatorio |
|---|---|---|---|
| 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 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
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.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.
- 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ámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| user | String | A nivel de comercio UID | Obligatorio |
| sign | String | Signature | Obligatorio |
| method | String | v3.GetFXQuote | Obligatorio |
| time | Long | Timestamp | Obligatorio |
- Parámetros
| Parámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| sell_currency | String | Currency to sell | Obligatorio |
| buy_currency | String | Currency to buy | Obligatorio |
| currency | String | Currency to sell if currency matches sell_currency; otherwese, the currency to buy | Obligatorio |
| amount | String | Amount to sell if currency matches sell_currency; otherwese, the amount to buy | Obligatorio |
| tenor | String | TOD or SPOT | Obligatorio |
| request_id | String | ID de solicitud único; se recomienda una combinación de al menos 24 dígitos y letras | Obligatorio |
Ejemplo de firma:
Parámetros ordenados y concatenados en una cadena de consulta con formato de URL
"amount=1&buy_currency=DKK¤cy=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:
- Si la llamada se realiza correctamente, se devuelve "status": true es returned.
- Si la llamada falla, se devuelve "status": false es returned.
Códigos de respuesta:
| 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 |
