交易日誌

整個賬戶統一錢包裡的交易日誌, 支持最多查詢過去2年的數據

信息

• 在極端市場波動期間, 此介面可能會出現延遲增加或資料傳遞暫時延遲的情況

HTTP 請求

GET /v5/account/transaction-log

請求參數

參數	是否必需	類型	說明
accountType	false	string	錢包類型. 僅支持UNIFIED
category	false	string	交易產品類型 spot,linear,option,inverse
currency	false	string	貨幣
baseCoin	false	string	交易幣種. 例如： BTCUSDT 的 baseCoin 是 BTC
type	false	string	交易日誌的類型
transSubType	false	string	movePosition, 僅用於篩選移倉產生的交易流水
startTime	false	integer	開始時間戳 (毫秒) startTime 和 endTime都不傳入, 則默認返回最近24小時的數據 startTime 和 endTime都傳入的話, 則確保endTime - startTime ≤ 7天 若只傳startTime，則查詢startTime和startTime+24小時的數據 若只傳endTime，則查詢endTime-24小時和endTime的數據
endTime	false	integer	結束時間戳 (毫秒)
limit	false	integer	每頁數量, 最大50. 默認每頁20條
cursor	false	string	游標，用於翻頁

響應參數

參數	類型	說明
list	array	Object
> id	string	唯一id
> symbol	string	合約名稱
> category	string	產品類型
> side	string	方向. Buy,Sell,None
> transactionTime	string	交易時間戳（毫秒）
> type	string	類型
> transSubType	string	交易子類型, movePosition, 標識移倉產生的流水. 默認""
> qty	string	數量. 現貨: 正的qty表示該幣數量增加, 負的qty表示該幣數量減少 期貨: 對於成交的流水來說, 這裡的qty表示每筆成交的數量, 不帶方向
> size	string	倉位. 特別地, 對於成交的流水來說, 這裡的size表示成交後的倉位大小, 帶有方向, 比如空倉, 則有"-"
> currency	string	USDC、USDT、BTC、ETH
> tradePrice	string	交易價格
> funding	string	資金費用. 正數表示用戶收取xx資金費, 負數表示用戶支出xx資金費 對於USDC永續合約, 由於資金費結算週期和8小時結算的週期一致, 所以您會看到資金費和8小時結算的數據存在於同一條流水中(type=SETTLEMENT), 您可以通過funding來確定資金費用, 以及cashFlow來確定8小時平倉盈虧
> fee	string	手續費, 正數表示用戶付出xx手續費, 負數表示返佣
> cashFlow	string	現金流, 比如平倉時的未平盈虧結算, USDC永續和交割合約的8小時結算, 以及劃入劃出等. 該值不包含任何手續費或者資金費
> change	string	變更 = cashFlow + funding - fee
> cashBalance	string	餘額（當前幣種）, 資金流發生後的該幣種的錢包餘額
> feeRate	string	對於type=TRADE, 則表示交易手續費率 對於type=SETTLEMENT, 則表示資金費率. 當side=Buy, feeRate=市場結算費率; 當side=Sell, feeRate=-市場結算費率
> bonusChange	string	體驗金的變化
> tradeId	string	交易id
> orderId	string	訂單id
> orderLinkId	string	用戶自定義訂單id
> extraFees	string	交易費率。目前，僅針對在印尼網站的現貨訂單或在歐盟站的現貨法定貨幣訂單返回此數據。在其他情況下，傳回空字串。 字段枚舉: feeType, subFeeType
nextPageCursor	string	游標，用於翻頁

---

請求示例

HTTP

GET /v5/account/transaction-log?accountType=UNIFIED&category=linear&currency=USDT HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672132480085
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_transaction_log(
    accountType="UNIFIED",
    category="linear",
    currency="USDT",
))

Node.js

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

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

client
    .getTransactionLog({
        accountType: 'UNIFIED',
        category: 'linear',
        currency: 'USDT',
    })
    .then((response) => {
        console.log(response);
    })
    .catch((error) => {
        console.error(error);
    });

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "nextPageCursor": "21963%3A1%2C14954%3A1",
        "list": [
            {
                "transSubType": "",
                "id": "592324_XRPUSDT_161440249321",
                "symbol": "XRPUSDT",
                "side": "Buy",
                "funding": "-0.003676",
                "orderLinkId": "",
                "orderId": "1672128000-8-592324-1-2",
                "fee": "0.00000000",
                "change": "-0.003676",
                "cashFlow": "0",
                "transactionTime": "1672128000000",
                "type": "SETTLEMENT",
                "feeRate": "0.0001",
                "bonusChange": "",
                "size": "100",
                "qty": "100",
                "cashBalance": "5086.55825002",
                "currency": "USDT",
                "category": "linear",
                "tradePrice": "0.3676",
                "tradeId": "534c0003-4bf7-486f-aa02-78cee36825e4",
                "extraFees":""
            },
            {
                "transSubType": "",
                "id": "592324_XRPUSDT_161440249321",
                "symbol": "XRPUSDT",
                "side": "Buy",
                "funding": "",
                "orderLinkId": "linear-order",
                "orderId": "592b7e41-78fd-42e2-9aa3-91e1835ef3e1",
                "fee": "0.01908720",
                "change": "-0.0190872",
                "cashFlow": "0",
                "transactionTime": "1672121182224",
                "type": "TRADE",
                "feeRate": "0.0006",
                "bonusChange": "-0.1430544",
                "size": "100",
                "qty": "88",
                "cashBalance": "5086.56192602",
                "currency": "USDT",
                "category": "linear",
                "tradePrice": "0.3615",
                "tradeId": "5184f079-88ec-54c7-8774-5173cafd2b4e",
                "extraFees":""
            },
            {
                "transSubType": "",
                "id": "592324_XRPUSDT_161407743011",
                "symbol": "XRPUSDT",
                "side": "Buy",
                "funding": "",
                "orderLinkId": "linear-order",
                "orderId": "592b7e41-78fd-42e2-9aa3-91e1835ef3e1",
                "fee": "0.00260280",
                "change": "-0.0026028",
                "cashFlow": "0",
                "transactionTime": "1672121182224",
                "type": "TRADE",
                "feeRate": "0.0006",
                "bonusChange": "",
                "size": "12",
                "qty": "12",
                "cashBalance": "5086.58101322",
                "currency": "USDT",
                "category": "linear",
                "tradePrice": "0.3615",
                "tradeId": "8569c10f-5061-5891-81c4-a54929847eb3",
                "extraFees":""
            }
        ]
    },
    "retExtInfo": {},
    "time": 1672132481405
}