跳至主要内容

12.1 取得代付匯率(系統即時)

#簡單描述: 取得代付匯率介面(系統即時)

查詢參數

參數名稱類型必填參數意義參數說明
keystring商家 keyapiKey
currencystring幣種(訂單幣種)範例:CNY
userCurrencystring用戶實收幣種範例:USDT
signstringmd5 簽章詳情請見簽章演算法(文件2)
請求json範例
{
"key": "9yUreYgTRtit39Dy",
"currency": "CNY",
"userCurrency": "USDT",
"sign":"dbc72adf640a82e0b21f98c50afb2881"
}

傳回值

參數名稱類型參數意義參數說明
codeint請求狀態通訊狀態 成功回傳:0,其它表示失敗
successboolean成功狀態true 成功
messagestring說明
datajson參數參數詳見下列說明
返回範例
{  
    "code": 0,
    "success": true,
    "message": null,
    "data": {
       "baseCurrency": "USDT",
       "quoteCurrency": "CNY",
       "tradePair": "USDT/CNY",
       "rate": 7.10324538,
       "costRate": 0.14078072015020265,
       "costReverseRate": 7.10324538,
       "exchangeAction": "BUY",
       "quoteExpression": "1USDT≈7.1032CNY",
       "baseAmount": "14.078072",
       "quoteAmount": "100"
    }
}
data參數說明
參數名稱類型參數意義參數說明
baseCurrencystring基礎貨幣
quoteCurrencystring報價貨幣
tradePairstring交易對
ratestring售價
costRatenumber計算價格( FROM x rate = TO )
costReverseRatenumber反相計算價格( TO x rate = FROM )
exchangeActionenum交易類型BUY:買入| SELL: 賣出
quoteExpressionstring匯率表達式以報價記的表達式
baseAmountstring基本金額範例基礎金額
quoteAmountstring報價金額範例報價金額