查詢兌換歷史

那些被確認的報價單, 不管最終狀態如何, 該接口都會返回

信息

自 2025 年 9 月 10 日起，前端進行的閃兌也可以在此介面中查詢到

HTTP 請求

GET /v5/asset/exchange/query-convert-history

請求參數

參數	是否必需	類型	說明
accountType	false	string	錢包類型 eb_convert_funding: 資金錢包閃兌紀錄(API) eb_convert_uta: uta錢包閃兌紀錄(API) funding: 資金錢包普通幣幣兌換(網頁/APP) funding_fiat: 資金錢包數法兌換(網頁/APP) funding_fbtc_convert: 資金錢包FBTC兌換成BTC(網頁/APP) funding_block_trade: 大宗兌換兌換(網頁/APP) 支持傳遞多個, 用逗號分開 比如, eb_convert_funding,eb_convert_uta 當不傳時, 默認返回所有錢包
index	false	integer	頁碼 從1開始 不傳時, 默認返回第一頁
limit	false	integer	每頁數量 默認20條 最多支持100條, 大於100, 按照100返回

響應參數

參數	類型	說明
list	array<object>	報價單列表
> accountType	string	eb_convert_funding: 資金錢包閃兌紀錄(API) eb_convert_uta: uta錢包閃兌紀錄(API) funding: 資金錢包普通幣幣兌換(網頁/APP) funding_fiat: 資金錢包數法兌換(網頁/APP) funding_fbtc_convert: 資金錢包FBTC兌換成BTC(網頁/APP) funding_block_trade: 大宗兌換兌換(網頁/APP)
> exchangeTxId	string	報價單ID, 和quoteTxId保持一致
> userId	string	用戶ID
> fromCoin	string	兌出幣種
> fromCoinType	string	兌出幣種類型. crypto
> toCoin	string	兌入幣種
> toCoinType	string	兌入幣種類型. crypto
> fromAmount	string	兌出幣種數量
> toAmount	string	兌入幣種數量
> exchangeStatus	string	兌換狀態 init processing success failure
> extInfo	object
>> paramType	string	如果您在申請報價接口中中有發送該字段, 則這裡會釋出該字段
>> paramValue	string	如果您在申請報價接口中中有發送該字段, 則這裡會釋出該字段
> convertRate	string	兌換率
> createdAt	string	報價單創建時間

請求示例

HTTP

GET /v5/asset/exchange/query-convert-history?accountType=eb_convert_uta,eb_convert_funding HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1720074159814
X-BAPI-RECV-WINDOW: 5000

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.get_convert_history(
    accountType="eb_convert_uta,eb_convert_funding",
))

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
  testnet: true,
  key: 'xxxxxxxxxxxxxxxxxx',
  secret: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
});

client
  .getConvertHistory()
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

響應示例

{
    "retCode": 0,
    "retMsg": "ok",
    "result": {
        "list": [
            {
                "accountType": "eb_convert_funding",
                "exchangeTxId": "10100108106409343501030232064",
                "userId": "XXXXX",
                "fromCoin": "ETH",
                "fromCoinType": "crypto",
                "fromAmount": "0.1",
                "toCoin": "BTC",
                "toCoinType": "crypto",
                "toAmount": "0.00534882723991",
                "exchangeStatus": "success",
                "extInfo": {
                    "paramType": "opFrom",
                    "paramValue": "broker-id-001"
                },
                "convertRate": "0.0534882723991",
                "createdAt": "1720071899995"
            },
            {
                "accountType": "eb_convert_uta",
                "exchangeTxId": "23070eb_convert_uta408933875189391360",
                "userId": "XXXXX",
                "fromCoin": "BTC",
                "fromCoinType": "crypto",
                "fromAmount": "0.1",
                "toCoin": "ETH",
                "toCoinType": "crypto",
                "toAmount": "1.773938248611074",
                "exchangeStatus": "success",
                "extInfo": {},
                "convertRate": "17.73938248611074",
                "createdAt": "1719974243256"
            }
        ]
    },
    "retExtInfo": {},
    "time": 1720074457715
}