查詢交易日誌

UNIFIED賬戶的交易日誌。

HTTP 請求

GET /unified/v3/private/account/transaction-log

請求參數

參數	是否必需	類型	說明
category	true	string	產品類型. linear,option
currency	true	string	幣種. 比如：USDC、USDT、BTC、ETH
baseCoin	false	string	交易幣種
type	false	string	默認返回該category下所有交易日誌（除劃轉外）. 注意: 查詢轉入轉出日誌，必須要傳 type=TRANSFER_IN，type=TRANSFER_OUT，否則查不到劃轉日誌.
startTime	false	integer	開始時間戳（毫秒）
endTime	false	integer	結束時間戳（毫秒）
direction	false	string	搜索方向：prev:上一頁,next:下一頁,默認為 next
limit	false	integer	每頁數量限制. [1, 50]. 默認: 20
cursor	false	string	游標，用於分頁

響應參數

參數	類型	說明
category	string	產品類型
currency	string	幣種
list	array	Object
> transactionTime	number	交易時間戳 (毫秒)
> type	string	類型
> symbol	string	合約名稱
> side	string	方向. Buy,Sell,None
> qty	string	訂單數量
> size	integer	倉位數量
> tradePrice	string	交易價格
> funding	string	資金費用
> fee	string	手續費，取資產的fee，正數表示用戶付出xx手續費，負數表示賺取
> cashFlow	string	現金流
> change	string	變更
> cashBalance	string	余額（當前幣種）
> feeRate	string	手續費率
> tradeId	string	交易ID
> orderId	string	訂單ID
> orderLinkId	string	用戶自定義訂單ID
nextPageCursor	string	游標，用於分頁

請求示例

GET /unified/v3/private/account/transaction-log?category=linear&currency=USDC&limit=1&type=SETTLEMENT HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672023156071
X-BAPI-RECV-WINDOW: 5000

響應示例

{
    "retCode": 0,
    "retMsg": "Success",
    "result": {
        "nextPageCursor": "1516%3A0%2C1516%3A0",
        "currency": "USDC",
        "category": "linear",
        "list": [
        {
            "symbol": "BTCPERP",
            "side": "None",
            "funding": "0.00000000",
            "orderLinkId": "",
            "orderId": "",
            "fee": "",
            "change": "0.00000000",
            "cashFlow": "0.00000000",
            "transactionTime": 1666857600000,
            "type": "SETTLEMENT",
            "feeRate": "",
            "size": "0.0000",
            "qty": "",
            "cashBalance": "22.96780168",
            "tradePrice": "",
            "tradeId": ""
        }
    ]
},
    "retExtInfo": {},
    "time": 1672023157776
}