跳至主要内容

獲取交易報價

在執行購買或贖回交易前獲取價格報價。調用 執行購買 或 執行贖回 前必須先調用此接口。

信息
  • 返回預估接收數量、匯率、平台手續費、Gas 費用及滑點
  • quoteData 和 correctingCode 必須原樣傳入執行接口，不得修改
  • 報價在 expireTime 後過期，過期後須重新獲取
  • correctingCode 為 (quoteData + fromTokenCode + fromTokenAmount + toTokenCode) 的 MD5 校驗碼，用於防篡改
  • 代幣代碼可通過 獲取支付代幣列表（CEX 代幣）及 獲取業務代幣列表（DEX 代幣）獲取

HTTP 請求​

POST/v5/alpha/trade/quote

請求參數​

參數是否必需類型說明
tradeTypetrueinteger交易類型。1: 購買（用支付代幣買入鏈上代幣），2: 贖回（賣出鏈上代幣換支付代幣）
fromTokenCodetruestring源代幣代碼（CEX_<id> 或 DEX_<id>）。購買填 CEX 代幣（如 USDT 對應 CEX_1）；贖回填 DEX 代幣（如 DEX_123）
fromTokenAmounttruestring支付數量，字符串格式的正小數，須大於 0
toTokenCodetruestring目標代幣代碼（CEX_<id> 或 DEX_<id>）。購買填 DEX 代幣；贖回填 CEX 代幣（如 USDT 對應 CEX_1）
quoteModefalseinteger報價模式。0: 自動（默認），1: 價格優先，2: 成功率優先

響應參數​

參數類型說明
tradeTypeinteger交易類型回顯
fromTokenCodestring源代幣代碼
fromTokenAmountstring支付數量
fromTokenAmountUsdstring支付金額（USD）
toTokenCodestring目標代幣代碼
toTokenAmountstring預估接收數量
toTokenAmountUsdstring預估接收金額（USD）
minToTokenAmountstring扣除滑點後最低接收數量
slippagestring預估滑點（小數），如 0.005 = 0.5%
gasstring預估 Gas 費用（原生代幣單位）
gasUsdstringGas 費用（USD）
platformFeestring平台手續費
platformFeeUsdstring平台手續費（USD）
swapRatestring兌換匯率（每單位 fromToken 可換 toToken 數量）
lossRatestring含手續費與滑點的預估損耗率
quoteDatastringBase64 編碼報價數據。必須原樣傳入執行接口，不得修改
correctingCodestring數據完整性 MD5 校驗碼。必須原樣傳入執行接口
quoteModeinteger實際使用的報價模式
quoteDataIdstring唯一報價 ID，用於冪等性控制
expireTimeinteger報價過期時間（ms），過期後請勿使用該報價執行交易
timestampinteger報價時間戳（ms），可用於比較多個報價的新鮮度
chargeAmountstring收費金額
modeEstimationsarray其他模式的預估數據，供對比參考
> quoteModeinteger報價模式
> estimatedGasstring該模式預估 Gas 費用
> estimatedGasUsdstring該模式預估 Gas 費用（USD）
> estimatedSlippagestring該模式預估滑點

請求示例​

POST /v5/alpha/trade/quote HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1704067200000
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "tradeType": 1,
    "fromTokenCode": "CEX_1",
    "fromTokenAmount": "100",
    "toTokenCode": "DEX_123",
    "quoteMode": 0
}

響應示例​

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "tradeType": 1,
        "fromTokenCode": "CEX_1",
        "fromTokenAmount": "100",
        "fromTokenAmountUsd": "100.00",
        "toTokenCode": "DEX_123",
        "toTokenAmount": "12500000",
        "toTokenAmountUsd": "99.50",
        "minToTokenAmount": "12375000",
        "slippage": "0.005",
        "gas": "0.0003",
        "gasUsd": "0.30",
        "platformFee": "0.20",
        "platformFeeUsd": "0.20",
        "swapRate": "125000",
        "lossRate": "0.005",
        "quoteData": "eyJhbGciOiJIUzI1NiJ9...",
        "correctingCode": "a1b2c3d4e5f6",
        "quoteMode": 0,
        "quoteDataId": "QD_20240101_001",
        "expireTime": 1704067230000,
        "modeEstimations": [
            {
                "quoteMode": 1,
                "estimatedGas": "12600000",
                "estimatedGasUsd": "0.28",
                "estimatedSlippage": "0.008"
            },
            {
                "quoteMode": 2,
                "estimatedGas": "12400000",
                "estimatedGasUsd": "0.35",
                "estimatedSlippage": "0.003"
            }
        ]
    },
    "retExtInfo": {},
    "time": 1704067200000
}